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SECTION  1 - INTRODUCTION 


1.1  Purpose  and  Scope 

This  document  provides  user  information  for  the  Data  Reduction  and  Analysis 
(RA)  System,  which  consists  of  four  executable  programs  that  perform  off- 
line analysis  of  the  CFC  Archive  Log  Queue  (ALQ)  Tapes,  the  System  Analy- 

* sis  Recording  (SAR)  Tapes,  and  the  CFC  Data  Base.  The  four  programs  are: 

• Archive  Log  Queue  (ALQ)  Tape  Filter  Program  (ALQFLTR) 

• ALQ  Filtered  Data  Report  Generator  Program  (ALQRPT) 

• System  Analysis  Recording  (SAR)  Dump  Program  (SARDMP) 

• Data  Base  Analysis  Program  (DBANAL) 

The  ALQFLTR  Program  performs  all  filtering  of  the  ALQ  set.  The  output 

filtered  data  set  from  this  program  is  then  input  to  the  ALQRPT  Program 

for  analysis  of  the  CFC  on-line  message  traffic  or  to  the  DBANAL  Program 
I 

for  analysis  of  the  data  base  statistics  records. 

The  ALQFLTR  Program  allows  filtering  the  ALQ  data  by  time  interval,  message 
source,  message  destination,  message  type,  airport/center  identification, 
or  record  type. 

The  ALQRPT  Program  receives  as  input  the  filtered  data  set  output  from  the 
ALQFLTR  Program.  This  program  has  five  report  options: 

• • IOLOG — A listing  of  all  input  and  output  messages  from  the 

input  filtered  data  set. 

t 

• IOSTAT — A summary  of  statistical  information  on  the  voltime 
and  distribution  of  input  and  output  messages  on  the  input 
filtered  data  set. 
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• IOSUM--A  histogram  of  selected  messages  in  equal  time  intervals. 

• RTSUM--A  statistical  summary  of  the  amount  of  time  required 
by  CFC  to  produce  an  output  message  in  response  to  an  input 

message. 

• LOCCOMP — A comparison  of  input  and  output  messages  from  two 
input  filtered  data  sets. 

All  reports  may  be  sorted  by  time,  message  source,  message  destination, 
message  type,  or  airport/center  identification. 

The  SARDMP  Program  receives  as  input  a SAR  data  set  and  produces  a formatted 
hexadecimal  dump  of  the  data  on  the  input  set.  All  the  records  on  the 
input  set  may  be  dumped  or  specific  records  to  be  dumped  may  be  selected 
by  time  interval,  recording  codes  or  program  element  identifications 
(PE  IDs)  within  specified  recording  codes. 


The  DBANAL  Program  performs  the  data  base  analysis  functions.  DBANAL  has 
four  modes  of  operation: 

• DBSTUP — Recreation  of  the  data  base  to  any  point  in  time  using 
an  off-line  copy  of  the  data  base  and  the  data  base  recovery 
set . 

e FRSTAT--A  statistical  summary  of  data  contained  in  both  the  OAG 
and  Non-OAG  Flight  Record  Sets  including  total  number  of  records 
as  well  as  summaries  by  arrival  terminal,  departure  terminal, 
and  arrival/departure  pairs. 

• FRC0MP--A  comparison  of  two  OAG  Flight  Record  Sets  and  two 

I j 

Non-OAG  Flight  Record  Sets  identifying  mismatch  and  no-match 
records . 
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• DBSUM--A  statistical  summary  of  the  data  base  activity  as  logged 
on  the  ALQ  set  in  the  data  base  statistics  records. 

• DBLOG — A listing  of  the  data  base  statistics  records  from  the 
filtered  ALQ  file. 

• DBLOCK — A statistical  summa';  of  the  data  base  locks  by  table 
accessed  and  type  of  lock. 

1.2  Background  Information 

ALQ  data  is  recorded  continuously  by  the  on-line  CFC  System.  The  ALQFLTR 
Program  provides  the  user  with  a flexible  means  of  extracting  from  a 
large  volume  of  data  only  that  data  which  the  user  is  interested  in 
analyzing.  ALQRPT  provides  the  mechanism  for  analyzing  the  selected  data. 
ALQFLTR  filters  the  ALQ  file  and  sets  fields  in  the  header  of  each  record 
to  be  used  by  ALQRPT.  For  this  reason,  the  ALQ  file  to  be  processed  by 
ALQRPT  must  be  an  output  file  of  ALQFLTR.  The  on-line  CFC  data  base  is 
subject  to  constant  queries  and  changes  resulting  from  input  CFC  messages, 
The  DBANAL  Program  provides  a means  of  analyzing  data  base  activity  and 
when  necessary  creating  off-line  a duplicate  of  the  on-line  system  at 
any  point  in  time. 

SAR  tapes  contain  data  transferred  from  core  storage  to  magnetic  tape  during 
operation  of  the  CFC  Monitor  or  during  the  operation  of  NAS  Model  3 systems. 
The  data  is  used  in  systems  analysis  and  evaluation. 

1.3  Reference  Documents 

1.  CFC  System  Design  Document » CSC/SD-78/6172 

2.  CFC  Executive  Monitor  Handbook.  CSC/SD-78/6170 

3.  OS  SORT/MERGE  Program.  IBM  Systems  Reference  Library, 

Program  Number  3605-SM-023 

IBM  System/360  Operating  System:  Job  Control  Language  Reference 
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SECTION  2 - PROGRAM  DESCRIPTIONS 

2.1  Archive  Log  Queue  Tape  filter  Program  (ALQFLTR) 

2.1.1  General  Program  Description 

The  Archive  Log  Queue  (ALQ)  Tape  Filter  Program  (ALQFLTR)  selects  records 
from  the  input  ALQ  set  and  writes  the  selected  records  to  an  output  set. 

• The  ALQFLTR  Program  provides  the  user  with  a flexible  means  of  extracting 

from  a large  volume  of  data  only  that  data  which  the  user  is  interested 

f * 

in  analyzing.  The  output  set  containing  the  selected  ALQ  records  is  the 
input  set  required  by  the  ALQRPT  Program  and  the  DBANAL  Program  (if  the 
DBSUM,  DBLOG,  or  DBLOCK  option  is  requested).  Records  to  be  written  to 
the  filtered  output  set  may  be  selected  by  time  interval,  message  source, 
message  destination,  message  type,  airport/center  identification  or 
record  type.  If  no  record  selection  is  required,  the  ALQ  set  must  still 
be  processed  by  ALQFLTR  in  order  to  output  a set  in  a format  compatible 
for  input  to  ALQRPT  and  DBANAL. 

ALQFLTR  begins  by  reading  the  user-supplied  control  cards  from  the  SYSIN 
file.  The  control  cards  provide  input  and  output  file  DDNAMEs  and  the 
record  selection  criteria.  Records  from  the  input  ALQ  set  are  then  read; 
if  the  record  is  accepted  based  upon  the  selection  criteria,  it  is  written 
to  the  output  data  set.  Where  appropriate,  error  diagnostics  are  generated. 

« 

2.1.2  Program  Oper at ion 

ALQFLTR  reads  user-supplied  control  cards  from  the  SYSIN  file.  The  control 
cards  contain  the  DDNAMEs  of  the  input  and  output  files  and  the  record 
selection  criteria.  Input  files  include  the  error  message  file  and  the 
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ALQ  set.  Output  files  include  the  file  for  listing  control  cards  and 
error  diagnostics  and  the  file  for  the  output  filtered  data. 

The  control  cards  are  read,  the  selection  criteria  is  established,  and 
the  card  images  are  printed  with  appropriate  diagnostics.  If  no  errors 
are  encountered  on  the  control  cards , records  are  read  from  the  input 
ALQ  set.  The  record  is  compared  to  the  selection  criteria  and  if  accepted, 
it  is  written  to  the  output  data  set.  The  record  must  meet  all  filter 
criteria  specified  in  order  to  be  accepted.  Records  may  be  selected 
by  time  interval,  message  source,  message  destination,  message  type, 
airport/center  identification  or  any  combination  of  the  above.  The 
specific  function  of  selecting  Data  Base  statistics  records  by  record 
type  is  an  additional  option  available  for  users  of  the  Test  Case  Generator 
(TR)  who  require  an  output  set  containing  only  the  enhanced  record  type. 

If  the  user  chooses  selection  by  record  type,  no  other  selection  criteria 
may  be  specified. 

The  data  set  output  by  ALQFLTR  may  contain: 

• Input  CFC  messages  and  resulting  output  messages  to  be  input 
to  ALQRPT 

• Data  Base  statistics  records  for  input  to  DBANAL 

• Enhanced  message  records  for  input  to  TR 

2.1.3  Program  Inputs 
2.1. 3.1  Control  Cards 

The  control  cards  are  free  format;  any  number  of  cards  may  be  specified. 

The  following  rules  govern  the  control  card  format : 

• A dollar  sign  ($)  indicates  the  end  of  control  information  on 
a given  card. 


Multiple  control  card  keywords  with  the  associated  parameters 
may  appear  on  a single  card. 

A semicolon  (;)  is  used  to  separate  control  card  keyword 
parameters  Irom  the  next  keyword. 

Control  cards  should  be  bracketed  between  a 'START  $'  card 
and  a 'TERM  $'  card;  the  'START  $'  card  is  optional;  the 
'TERM  $'  card  is  required. 

Control  cards  may  contain  information  in  columns  1 through  72 
inclusive . 

Lists  of  keyword  parameters  are  separated  by  commas. 

No  keyword  may  be  duplicated  within  a control  card  set. 

Blanks  may  appear  anywhere  on  a control  card.  However,  since 

a blank  may  signal  the  end  of  a field  (e.g.,  keyword  or  keyword 

parameter),  a blank  should  not  be  embedded  within  a field. 

A control  card  field  may  be  one  to  eight  characters  in  length. 

A continuation  sign  (+)  may  follow  either  a semicolon  (;)  or 

a comma  (,).  This  sign  signals  that  no  further  information 

follows  on  the  current  card  but  that  the  stream  of  information 

is  continued  on  the  following  card. 

The  following  control  card  keywords  are  required: 

CNTLST 
ERR  IN 
ALQIN 
ALQOUT 
TERM 

The  following  control  card  keywords  are  optional : 

START 

TIME 

SOURCE 

DEST 

MSGTYP 

PLACE 

RECTYPE 

No  additional  keywords  will  be  accepted. 


| 


« 

I 

£ 

c 


I 


2-3 


I, 


2. 1.3. 1.1  START  $ (Optional) 

This  card  signals  the  beginning  of  the  control  card  stream. 


2. 1.3. 1.2  CNTLST  = DDNAME  $ (Required) 

CHTLST  - Keyword  preceding  the  print  file  DDNAME.  Since  this 
file  must  be  opened  prior  to  the  printing  of  any 
error  messages,  this  keyword  should  appear  early  in 
the  control  card  set. 


2. 1.3. 1.3  ERRIN  = DDNAME  $ (Required) 

ERRIN  - Keyword  preceding  the  error  file  DDNAME.  Since  this  , 

file  must  be  opened  for  reading  the  appropriate  error 
message,  this  keyword  should  appear  early  in  the 
control  card  set . 


2. 1.3. 1.4  ALQIN  = DDNAME  $ (Required) 

ALQIN  - Keyword  preceding  the  DDNAME  for  the  input  ALQ  file. 


2.1. 3. 1.5  ALQOUT  = DDNAME  $ (Required) 

ALQOUT  - Keyword  preceding  the  DDNAME  for  the  resulting  filtered 
ALQ  data  set.  The  data  set  associated  with  this  DD 
card  is  the  input  set  for  ALQRPT  or  DBANAL. 


2. 1.3. 1.6  TIME  =Lxr\  MMDDYY  (HHMMSS  - HHMMSS ) $ or 

TIME  = LX,1  MMDDYY  (HHMMSS)  - MMDDYY  (HHMMSS)  $ (Optional) 

TIME  - Time  range  filter  criteria  keyword. 

X - Specifies  that  all  records  falling  within  this  time  range 

are  to  be  excluded.  Default  is  'include'. 


MMDDYY  - Month  (ranging  from  01  to  12) 

Day  (ranging  from  01  to  31) 

Year  (ranging  from  77  to  present  year) 

If  the  range  if  within  the  same  24-hour  period,  it  is 
not  necessary  to  specify  MMDDYY  twice.  This  must  be  a 
6-digit  field. 

HHMMSS  - Hours  (ranging  from  00  to  23) 

Minutes  (ranging  from  00  to  59) 

Seconds  (ranging  from  00  to  59) 

This  must  be  a 6-digit  field. 


k 

► 
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2. 1.3. 1.7  SOURCE  = X,  AAAAA , AAAAA , AAAAA  $ (Optional) 


SOURCE  - Message  source  IP  filter  criteria  keyword. 

X - Any  record  with  one  of  the  specified  message  source 

IDs  shall  be  excluded.  Default  is  include. 

AAAAA  - A maximum  of  10  valid  message  source  IPs  may  be  specified 

Valid  source  IDs  are  as  follows: 

I 

CFCCSI 

TAEXEC 

TATRAN 

CFCCRD 

CI0T1 

CI0T2 

CI0T3 

CI0T4 

CCCIOT 


2. 1.3. 1.8  PEST  = X,  A, A, A, A $ (Optional) 

DEST  - Destination  output  device  filter  criteria  keyword. 

X - Any  record  with  one  of  the  specified  destination  output 

devices  shall  be  excluded.  Default  is  include. 

A - Any  of  the  following  destination  output  device  codes 

are  acceptable: 

G » Computer  Readout  Device  (ATCSCC) 

I = Console  Printer  (ATCSCC) 

H = HSP  (CFCF ) 

M = MSP  (ATCSCC) 

U = TTY  Reperf.  (ATCSCC) 

J = Computer  Readout  Device  (CFCF) 

K = Console  Printer  (CFCF) 

T = TTY  Reperf.  (CFCF) 


2. 1.3. 1.9  MSGTYP  = X,  AA,AAAA,AA  $ (Optional) 


MSGTYP  - Message  code  filter  criteria  keyword. 

X - Any  record  with  one  of  the  specified  message  codes 

shall  be  excluded.  Default  is  include. 


A A 


Any  of  the  26  valid  message  external  codes  (i.e.,  LISA, 
DEMA).  A maximum  of  13  may  be  specified. 


2-S 


2.1.3.1.10  PLACE  = X,  AAA, AAA, AAA  $ (Opt ional ) 


PLACE  - Airport /center  identification  filter  criteria  keyword. 

X - Any  record  with  one  of  the  specified  airport/center 

identifications  shall  be  excluded.  Default  is  include. 

AAA  - Any  valid  airport  or  center  external  code.  A maximum  of 

10  may  be  specified.  If  this  filter  criteria  is  specified, 
any  message  which  does  not  contain  a unique  airport/center 
identification  is  automatically  excluded. 


2.1.3.1.11  RECTYPE  = AAAAAAAA  $ (Optional) 


RECTYPE 

AAAAAAAA 


Keyword  preceding  the  type  of  record  to  be  selected. 

Specifies  the  requested  record  types.  Acceptable  record 
types  are : 


ENHANCED 

INIT 

OUTPUT 

REPORT 

TERM 

DBSTAT 


- just  enhanced  records  are  to  be  selected 

- initiation  records 

- output  records 

- report  records 

- termination  records 

- data  base  statistics  records 


Although  any  of  these  records  types  are  valid,  only 
RECTYPE= ENHANCED  sr  RECTYPE= DBSTAT  should  be  used  since 
no  support  programs  exist  to  process  data  sets  containing 
only  records  of  any  of  the  other  types.  This  parameter 
when  used  excludes  all  other  selection  criteria.  If 
specified,  all  records  of  the  type  requested  that  exist 
on  the  input  set  will  be  written  to  the  output  set. 

An  output  set  containing  only  enhanced  records  may  be 
processed  by  the  TR  Program;  an  output  set  containing  only 
DBSTAT  records  may  be  processed  by  the  DBANAL  Program  if 
the  report  request  is  DBSUM  or  DBLOCK. 


2.1.3.1.12  TERM  $ (Required) 

This  card  signals  the  end  of  the  control  card  set. 


2. 1.3. 2 Data  Cards 


There  are  no  data  cards  to  be  supplied  to  this  program. 


2. 1.3. 3 Data  Sets 


Three  input  data  sets  are  required  for  successful  operation  of  ALQFLTR: 

• The  partitioned  data  set  containing  the  error  messages 

• The  sequential  ALQ  set  to  be  filtered 

• The  control  card  set 


The  DDNAMEs  for  these  data  sets  are  defined  on  the  program  control  cards 

• ERRIN  = error  message  set  DDNAME 

• ALQIN  = ALQ  set  DDNAME 

The  control  card  set  DDNAME  must  be  SYSIN. 


The  format  of  these  data  sets  is  described  below. 


DATA  SET 

LRECL 

BLKSIZE 

RECFM 

DSORG 

ERROR  MESSAGES 

80 

80 

F 

P0 

ALQ  INPUT 

512 

512 

F 

PS 

CONTROL  CARDS 

80 

80 

F 

PS 

2. 1.3. 4 Job  Control  Language 

The  following  is  the  Job  Control  Language  (JCL)  for  executing  ALQFLTR. 

//  JOB  CARD 
/*SETUP  TAPE (2 ) 

//  EXEC  PGM= ALQFLTR, REGION=200K 

//STEPLIB  DD  DSN=RA. LIB. PROD. LOAD, DISP=SHR 

//RAERROR  DD  DSN=SPCX. LIB. ERROR. CURRENT, DISP=SHR 

//SYSPRINT  DD  SYSOUT=A,DCB=(RECFM=FBA,LRECL=133,BLKSIZE=1330) 

//RAALQIN  DD  DSN=ALQ. INPUT ,UNIT=2400 ,VOL=SER=TAPE  ID, 

//  DISP=OLD , DCB= ( RECFM=F , LRECL= 512 , BLKS IZE=  512 ) , 

//  LABEL=(1,NL) 

//RALQOUT  DD  DSN=ALQ. OUTPUT ,UNIT=2400 ,VOL=SER=TAPE  ID, 

//  DISP=( , KEEP ) , DCB= ( RECFM=F , LRECL= 512 , BLKS IZE=  512 ) , 

//  LABEL=(1,NL) 

//SYSIN  DD  * 

START  $ 

CNTLST=SYSPRINT ;ERRIN=RAERROR ; ALQIN=RAALQIN ;ALQOUT=RALQOUT  $ 


selection  criteria  cards 


TERM  $ 
/* 

// 
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2. 1.3. 5 Input  Examples 


1.  Filter  ALQ  Set  for  data  in  a specified  time  period. 

//  EXEC  PGM=ALQFLTR, REGION =200K 

//RAERROR  DD  DSN=SPCX. LIB. ERROR. CURRENT, DISP=SHR 

//SYSPRINT  DD  SYS0UT=A,DCB=(RECFM=FBA,LRECL=133,BLKSIZE=1330) 

//INPUT  DD  DSN=ALQ. INPUT ,UNIT=2400 ,V0L=SER=CF0000 , 

//  DISP=OLD,DCB=(RECFM=F ,LRECL=  512 ,BLKSIZE=512 ) , 

//  LABEL=(1,NL) 

//OUTPUT  DD  DSN=ALQ. OUTPUT, UNIT=2400,VOL=SER=CF1111, 

//  DISP= ( NEW , KEEP ) ,DCB= ( RECFM=F , LRECL= 512 ,BLKSIZE=  512 ) , 

//  LABEL= (l,NL) 

//SYSIN  DD  ** 

START  $ 

CNTLST=SYSPRINT;ERRIN=RAERROR,  $ 

ALQ IN= I NPUT ; ALQOUT= OUTPUT  $ 

TIME=010178  (013000-053000)  $ 

TERM  $ 


2.  Filter  ALQ  Set  for  data  in  a specified  time  period  and  specified 

message  types.  Using  the  above  JCL,  the  control  cards  are  as  follows: 

START  $ 

CNTLST=SYSPRINT;ERRIN=RAERROR  $ 

ALQ IN  = INOUT ; ALQOUT = 0UTEUT  $ 

TIME=060979  (010000)  - 061079  (010000)  $ 

MSGTYP=LIFP, LISA, DEM*  $ 

TERM  $ 


r = 

2.1.4  Program  Outputs 

There  are  two  data  sets  output  by  ALQFLTR: 

• A sequential  data  set  containing  control  card  images, 
appropriate  error  diagnostics,  and  program  summary  information 

• A sequential  filtered  ALQ  set 

The  DDNAMES  for  the  output  data  sets  are  specified  as  control  card 
parameters  and  are  required  for  successful  program  operation: 

• CNTLST  = print  file  DDNAME 

• ALQOUT  = filtered  ALQ  set  DDNAME 

The  format  of  the  data  sets  is  described  below: 


DATA  SET 

LRECL 

BLKSIZE 

RECFM 

DSORG 

PRINT  FILE 

133 

1330 

FBA 

PS 

ALQ  OUTPUT 

512 

512 

F 

PS 

2. 1.4.1  Diagnostics 

Diagnostics  generated  by  ALQFLTR  fall  into  three  categories: 

• User  abend  codes 

• Error  messages 

• I/O  module  messages 

The  following  user  abends  may  occur: 

USER  = 0001 

Meaning:  This  abend  is  output  by  the  module  RAFLTR.  Either  the 
input  error  message  file  (specified  by  the  control  card  ERRIN= 
DDNAME)  or  the  output  print  file  (specified  by  the  control  card 
CNTLST= DDNAME)  could  not  be  opened.  The  probable  cause  is  that 
the  DDNAME  specified  was  not  provided  in  the  JCL.  Refer  to  the 
associated  I/O  message  on  the  HASP  output  log. 


f 
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USER  = 0002 

Meaning:  This  abend  is  output  by  the  module  RAFPAR.  This  abend 
is  a code  default  and  if  it  occurs,  it  indicates  a software  logic 
problem  in  the  module. 


USER  = 0003 

Meaning:  This  abend  is  output  by  the  module  RAFPAR.  This  abend 
is  a code  default  and  if  it  occurs,  it  indicates  a software  logic 
problem  in  the  module. 

USER  = 0004 

Meaning:  This  abend  is  output  by  the  module  RAFLDV.  This  abend  is 
a code  default  and  if  it  occurs , it  indicates  a software  logic 
problem  in  the  module. 

USER  = 0005 

Meaning:  This  abend  is  output  by  the  module  RACFIL.  This  abend  is 
a code  default  and  if  it  occurs,  it  indicates  a software  logic 
problem  in  the  module. 

The  following  are  error  messages  that  may  be  printed  and  the  condition 
indicated  will  cause  program  termination. 

MESSAGE : RA001  INVALID  CHARACTER  IN  CONTROL  CARD  FIELD 

Meaning:  An  unacceptable  non-alphanumeric  character  was  encountered 
on  a control  card.  Compool  table  BH  contains  the  valid  special 
characters . 


MESSAGE : RA002  FIELD  LENGTH  EXCEEDS  EIGHT  CHARACTERS 

Meaning:  A control  card  keyword  or  keyword  parameter  was  found  to 

be  greater  than  8 characters  in  length. 
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MESSAGE:  RA003  MISSING  OR  INVALID  CONTROL  CARD  KEYWORD 


Meaning:  An  acceptable  control  card  keyword  was  not  encountered 

at  the  onset  of  a keyword  expression.  The  intended  keyword  is 

either  misspelled  or  has  been  omitted.  The  following  keywords 

are  acceptable: 

CNTLST  TIME 

ERRIN  SOURCE 

ALQIN  DEST 

ALQOUT  MSGTYP 

START  PLACE 

TERM  RECTYPE 


MESSAGE:  RA004  MISSING  OR  INVALID  VALUE  - XXXX  EXPECTED 
Meaning:  An  equal  sign  or  other  delimiter  was  not  encountered  at 
the  appropriate  point  in  the  keyword  expression. 

MESSAGE:  RA005  INVALID  TIME/DATE  ENTRY 

Meaning:  A portion  of  the  time/date  field  includes  an  out  of 
range  value,  a field  is  not  six  digits,  or  the  time/date  entries 
do  not  represent  a time  range. 

MESSAGE : RA006  DUPLICATE  CONTROL  CARD  KEYWORD  OR  DDNAME 

Meaning:  A keyword  preceding  a DDNAME  or  parameter  has  been 
repeated  within  the  same  control  card  set. 

MESSAGE:  RA007  TOO  MANY  IDENTIFIERS  FOR  KEYWORD 

Meaning:  The  maximum  allowable  number  of  parameters  for  a particular 
keyword  has  been  exceeded.  Compool  table  15  contains  the  maximum 
values  and  associated  keywords. 


MESSAGE:  RA008  INVALID  IDENTIFIER  IN  DESTINATION  FIELD 


Meaning:  One  of  two  possible  errors  has  occurred.  The  parameter 

following  the  destination  output  device  keyword  is  not  acceptable. 

Acceptable  values  are: 

G U 
I J 
H K 
M T 

The  parameter  following  the  record  type  keyword  is  not  acceptable. 
Compool  table  LO  contains  the  valid  selections. 

MESSAGE:  RA014  INVALID  IDENTIFIER  IN  SOURCE  FIELD 
Meaning:  The  parameter  following  the  message  source  keyword  is 
not  an  acceptable  message  source  identification  code.  Compool 
table  KX  contains  the  acceptable  values. 

MESSAGE:  NO  TERM  CARD  FOUND 

Meaning:  An  end-of-file  was  encountered  on  the  control  card  set; 
however,  no  TERM  card  was  encountered  signifying  the  end  of  the 
control  cards. 

MESSAGE:  RA015  HEADER  MESSAGE  SOURCE  ID  XXX  NOT  FOUND  IN  TABLE 
OF  VALID  ID's 

Meaning:  The  record  being  processed  contained  a source  identification 
that  was  not  valid.  Compool  table  KX  contains  the  valid  source  ID's. 

MESSAGE : UNSUCCESSFUL  RUN  - IOERR 

Meaning:  This  message  is  a summary  message  indicating  an  I/O  error 
was  encountered  by  one  of  the  I/O  modules.  Refer  to  the  associated 
I/O  message  on  the  HASP  output  log. 
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The  following  are  I/O  module  messages  which  appear  on  the  HASP  log.  In 
all  cases,  an  I/O  error  will  result  in  program  termination. 


MESSAGE : AAAAAAAA  ERROR  ON  OPEN 

Meaning:  The  data  set  associated  with  the  DDNAME  (AAAAAAAA)  could 
not  be  opened.  The  probable  cause  is  that  the  DDNAME  indicated 
was  not  provided  in  the  JCL. 

MESSAGE:  AAAAAAAA  GIVES  TOO  MANY  PDS  FILES 

Meaning:  The  maximum  number  of  partitioned  data  sets  that  may  be 

open  at  any  one  time  is  5.  AAAAAAAA  is  the  DDNAME  of  the  file 
to  be  opened  when  the  limit  was  exceeded. 

MESSAGE:  AAAAAAAA  GIVES  TOO  MANY  I/O  FILES 

Meaning:  The  maximum  number  of  I/O  data  sets  that  may  be  open  at 
any  one  time  is  20.  AAAAAAAA  is  the  DDNAME  of  the  data  set  to 
be  opened  when  the  limit  was  exceeded. 

MESSAGE:  AAAAAAAA  IS  UNABLE  TO  GET  SUFFICIENT  CORE  FOR  DCB 
Meaning:  There  was  insufficient  core  available  when  the  data  set 
specified  by  the  DDNAME  (AAAAAAAA)  indicated  was  to  be  opened. 
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2.2  Archive  Log  Queue  Filtered  Data  Report  Generator  Program  (ALQRPT) 


2.2.1  General  Program  Description 

The  ALQ  Filtered  Data  Report  Generator  Program  provides  analysis  of 
selected  ALQ  data  in  specified  report  form:  the  input/output  log  compare 
report,  response  time  summary  report,  input/output  log  list  report, 
message  summary  report,  and  message  statistic  report. 

The  ALQ  Filtered  Data  Report  Generator  Program  can  generate  any  number  of 
these  reports  during  one  execution.  The  ALQ  Filtered  Data  Report 
Generator  Program  processes  a filtered  ALQ  file  (output  by  ALQFLTR)  to 
produce  response  time  statistics  based  on  message  initiation  to  message 
termination  time;  a formatted  listing  of  the  records  on  a filtered  ALQ 
file;  a summary  report  of  the  frequency  of  messages  depicted  in  a histo- 
gram and  a statistic  information  line;  a report  consisting  of  a one-line 
summary  of  rate,  number  of  occurrences,  and  other  statistical  information 
for  user-selected  fields  in  a message.  It  also  compares  a filtered  ALQ 
file  to  another  filtered  ALQ  file  and  produces  a report  consisting  of  a 
listing  of  mismatched  records  and  a summary  of  compare  statistics. 

2.2.2  Program  Operation 

The  ALQ  Filtered  Data  Report  Generator  Program  produces,  at  the  user 
request , any  or  all  of  the  following  reports . 

2. 2. 2.1  Input /Output  Log  Compare  Report.  Two  filtered  ALQ  files  are 
sorted  by  criteria  internal  to  the  log  compare  processor.  The  two  files 
are  then  compared  and  the  log  compare  report  is  generated.  The  compare 
program  first  compares  the  fields  that  the  data  sets  were  sorted  on 
(message  type,  message  source,  and  message  destination).  If  they  are 
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not  equal,  the  lesser  message  is  printed.  If  the  fields  that  the  data 
sets  were  sorted  on  compare  but  other  fields  do  not  compare,  both 
messages  will  be  printed  (see  Figure  2-1).  If  the  input  messages  match, 
the  output  messages  for  each  input  message  are  then  compared.  After 
both  files  have  been  processed,  a summary  report  is  generated  con- 
taining total  messages,  messages  that  matched,  messages  with  output 
errors,  and  messages  with  no  match  on  each  data  set  (see  Figure  2-2). 

2. 2. 2. 2 Response  Time  Summary  Report.  If  no  sort  field  is  specified, 
a report  is  generated  to  represent  the  response  time  range  for  all 
messages  on  a filtered  ALQ  file.  This  report  contains  a histogram 
depicting  the  response  times  and  a statistics  line  containing  total 
messages  processed,  average  response  time,  and  other  statistical  infor- 
mation. If  a sort  is  specified,  a histogram  and  statistics  line  are 
generated  for  each  value  of  the  specified  sort  fields  (see  Figure  2-3). 
Message  response  time  is  defined  as  the  elapsed  time  from  receipt  of 
the  message  in  the  CFC  System  to  termination  of  CFC  processing  of  the 
message . 

2. 2. 2. 3 Input/Output  Log  Report.  This  report  is  a formatted  listing 
of  enhanced  messages  and  associated  output  messages  for  a filtered  ALQ 
file.  For  each  message,  a heading  line  is  formatted  and  printed.  The 
enhanced  messages  and  associated  output  messages  are  then  printed. 
Finally,  the  heading  line  is  printed  with  the  termination  time  added 
(see  Figure  2-4). 

2. 2. 2. 4 Message  Summary  Report.  This  report  is  a summary  of  message 
rates  for  a filtered  ALQ  file.  If  no  sort  is  specified,  a report  is 
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generated  for  all  messages  on  the  file  depicting  the  number  of  messages 
in  given  time  intervals.  Also,  a statistics  line  is  formatted  con- 
taining total  messages,  average  message  rate,  and  other  statistical 
information.  If  a sort  is  specified,  a separate  report  is  generated 
for  each  value  of  the  specified  sort  fields  (see  Figure  2-5). 

2. 2. 2. 5 Message  Statistic  Report.  This  report  contains  statistical 
information  about  message  rates  such  as:  total  messages,  average 
message  rate,  maximum  messages  per  interval,  and  standard  deviation  of 
the  intervals.  This  information  is  formatted  into  a one-line  report. 

If  a sort  was  not  specified,  a one-line  report  is  generated  for  all 
messages  on  the  filtered  ALQ  file.  If  a sort  was  specified,  a one- 
line  report  is  generated  for  each  value  of  the  sort  fields  specified 
(see  Figure  2-6). 

2.2.3  Program  Inputfc 

2 ■ 2 . 3 . 1 Control  Cards 

The  control  cards  are  free  format;  any  number  of  cards  may  be  specified. 
The  following  rules  govern  the  control  card  format : 

• A dollar  sign  ($)  indicates  the  end  of  control  information 
on  a given  card 

• Multiple  control  card  keywords  with  the  associated  parameters 
may  appear  on  a single  card 

• A semicolon  ( ; ) is  used  to  separate  control  card  keyword 
parameters  from  the  next  keyword 


" 

j 

i 

- 


I 

I 
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• Control  cards  should  be  bracketed  between  a 'START  $'  card 
and  a 'TERM  $'  card;  the  'START  $'  card  is  optional;  the  'TERM  $*  card 
is  required 

• Control  cards  may  contain  information  in  columns  1 through  72 
inclusive 

• Lists  of  keyword  parameters  are  separated  by  commas 

• No  keyword  may  be  duplicated  within  a control  card  set 

• Blanks  may  appear  anywhere  on  a control  card.  However,  since 
a blank  may  signal  the  end  of  a field  (e.g.,  keyword  or  keyword  param- 
eter), a blank  should  not  be  embedded  within  a field 

• A control  card  field  may  be  one  to  eight  characters  in  length 

• A continuation  sign  (+)  may  follow  either  a semicolon  (;) 

or  a comma  (,).  This  sign  signals  that  no  further  information  follows 
on  the  current  card  but  that  the  stream  of  information  is  continued  on 
the  following  card 

• A 'TERM  $'  card  must  separate  each  report  request  if  multiple 

reports  are  being  requested  in  one  input  stream: 

START  $ 

REPORT=IOLOG  $ 

additional  control  cards  for  this  report 
TERM  $ 

REPORT=RTSUM  $ 

additional  control  cards  for  this  report 
TERM  $ 

Each  report  request  is  treated  separately  by  the  program.  Therefore,  all 
control  cards  required  for  a report  must  appear  with  that  report  request. 
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Control  card  errors  encountered  in  one  report  request  will  terminate 
processing  of  that  report  request  only.  Subsequent  report  requests  will 
be  processed. 

e The  following  are  required  control  card  Keywords  for  all 
reports : 

REPORT 

ERRIN 

CNTLST 

ALQIN  (or  ALQIN1 ) 

TERM 

e The  following  are  optional  keywords  for  all  reports: 

START 

SORT  (not  valid  for  Logcomp;  optional  on  all  other  reports) 

TIMINT  (required  for  IOSUM,  IOSTAT,  RTSUM;  not  valid  for 
IOLOG  or  LOGCOMP) 

ALQIN2  (required  for  LOGCOMP;  not  valid  for  any  other  reports) 

RPTINT  (optional  for  RTSUM;  not  valid  for  any  other  reports) 

TIMSPAN  (not  valid  for  IOLOG  and  LOGCOMP;  optional  for  all 
other  reports) 

2. 2. 3. 1.1  START  $ (optional) 

This  card  signals  the  beginning  of  the  control  card  stream. 

2. 2. 3. 1.2  REPORT=  AAAAAAAA  required) 

The  report  keyword  designates  which  report  is  to  be  generated.  The 
report  keyword  must  be  present.  The  possible  reports  are  listed  on 
the  following  page. 
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AAAAAAAA=LOGCOMP  ( Input/Output  Log  Compare  Report) 

=RTSUM  (Response  Time  Summary  Report) 

=IOLOG  ( Input /Output  Log  Report) 

=IOSUM  (Message  Summary  Report) 

=IOSTAT  (Message  Statistic  Report) 

2.2. 3. 1.3  ERRIN=  AAAAAAAA  (required) 

The  ERRIN  keyword  designates  the  DDNAME  of  the  error  message  file. 

The  ERRIN  keyword  must  be  present. 

AAAAAAAA=The  DDNAME  of  error  message  file 

2.2.3. 1.4  CNTLST= AAAAAAAA  (required) 

The  CNTLST  keyword  designates  the  DDNAME  of  the  file  to  which  the  control 
card  images  and  any  error  messages  are  to  be  written.  This  keyword 
must  be  present . 

AAAAAAAA-The  DDNAME  of  the  control  list  file 

2. 2. 3. 1.5  RPTLST= AAAAAAAA  (required) 

The  RPTLST  keyword  designates  the  DDNAME.  of  an  output  file  to  which  the 
reports  are  to  be  written.  This  keyword  must  be  present. 

2 . 2 . 3 . 1 . 6 SORT=  AAAAAAAA  X'l  ( opt  ional ) 

The  SORT  keyword  designates  the  fields  on  which  the  filtered  ALQ  file 
is  to  be  sorted.  The  SORT  keyword  may  not  be  included  in  a LOGCOMP  report 
request.  The  SORT  keyword  is  optional  for  all  other  reports.  A maximum 
of  two  sort  criteria  may  be  specified  by  including  two  SORT=VALl'E 
statements.  If  two  statements  are  used,  the  first  represents  the  primary 
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sort  field  and  the  second  the  secondary  sort  field.  The  possible  sort 
fields  are: 

AAAAAAAA=MSGTYPE  (Message  type,  i.e.,  LISA,  DEMA) 

= DEST  (Message  output  destination) 

=PLACE  (Message  airport/center  ID;  messages  with  multiple 
airport /center  IDs  will  be  grouped  together,  i.e., 
the  place  field  will  be  blank) 

=TIME  (Entry  time  of  the  message;  this  is  only  valid  for 
IOLOG  report ) 

=SOURCE  (Message  source) 

The  ',X'  symbol  represents  optional  type  of  sort  to  be  performed  on  the 
given  field.  The  default  is  ascending.  Possible  values  for  X are: 

X=A  Ascending 
X=D  Descending 

2. 2. 3. 1.7  TIMINT=HHMMSS  (optional) 

The  TIMINT  keyword  value  specifies  the  size  of  the  time  interval  for 
which  statistics  are  accumulated.  The  number  of  intervals  for  a given 
report  is  determined  by  the  time  spans  of  the  data  processed  divided  by 
the  time  interval  (TIMINT).  This  keyword  is  required  for  reports  IOSUM, 
IOSTAT,  and  RTSUM.  It  is  invalid  for  reports  IOLOG  and  LOGCOMP. 

HH=Hours  (ranging  from  00  to  23) 

MM=Minutes  (ranging  from  00  to  59) 

SS=Seconds  (ranging  from  00  to  59) 

Example : If  the  data  being  processed  ranges  in  time  from  1:00  (010000) 

to  2:00  (020000)  and  a time  interval  of  10  minutes  (TIMINT=001000) 
is  specified  for  the  reports  IOSUM  or  IOSTAT  (REP0RT=I0SUM  or 
REP0RT=I0STAT) , an  average  message  rate  will  be  computed  for 
each  10  minute  interval  (i.e.,  010000-011000,  for  011000-012000, 
etc.).  Similarly,  if  REP0RT= RTSUM,  an  average  response  time 
would  be  calculated  for  each  10  minute  interval. 


2.2.3.1.B  ALQIN=AAAAAAAA  (Optional) 

The  ALQIN  keyword  specifies  the  input  DDNAME  for  the  filtered  ALQ  file. 
It  must  be  specified  for  all  reports. 
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AAAAAAAA=Filtered  ALQ  file  input  DDNAME 
If  the  report  requires  a sort  to  be  done,  the  DDNAME  (AAAAAAAA)  must 
conform  to  the  standards  below.  A sort  is  done  whenever  the  SORT  keyword 
is  specified  or  if  REF’ORT=FTSUM  and  the  RPTINT  keyword  is  specified. 

The  DDNAME  must  be  in  the  format  AAAAIN  where 
AAAA  = any  four  characters 

IN  = mandatory  characters.  This  constraint  is  due  to  the 
formats  of  DDNAMEs  for  the  OS  sort /merge  utility. 

2. 2. 3. 1.9  ALQIN1=AAAAAA  (may  be  used  in  place  of  ALQIN) 

The  ALQIN1  keyword  designates  the  DDNAME  for  the  primary  filtered  ALQ 
file  for  the  LOGCOMP  report.  This  card  is  used  for  LOGCOMP  report  only. 
Because  the  sort  is  used,  the  DDNAME  must  be  in  the  format  'AAAAIN',  where 
AAAA  = any  four  characters  (different  from  ALQIN) 

IN  = mandatory  characters 


2.2.3.1.10  ALQIN2= AAAAAA 

The  ALQIN2  card  designates  the  DDNAME  for  the  secondary  filtered  ALQ  file. 
This  card  is  used  for  LOGCOMP  report  only.  Because  the  sort  is  used, 
the  DDNAME  must  be  in  the  format  'AAAAIN',  where 

AAAA  = any  four  characters  (different  from  ALQIN1) 

IN  = mandatory  characters 

2.2.3.1.11  RPTINT=HHMMSS 

The  RPTINT  (report  interval)  keyword  is  valid  only  for  the  response  time 
summary  report  (REP0RT=RTSUM) . The  RPTINT  option  allows  the  user  to 
indicate  the  start  time  of  the  report  rather  than  allowing  the  start 
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time  to  default  to  the  first  time  encountered  in  the  data  being  proc- 


essed. The  format  for  the  RrTINT  value  is  HHMMSS  where 
HM=Hours  (ranging  from  00-23) 

MM=Minutes  (ranging  from  00-59) 

SS=Seconds  (ranging  from  00-59) 

Example : If  the  first  time  encountered  for  the  data  is  012316  and  the 

user  has  specified  TIMINT  of  10  minutes,  the  default  intervals 
for  which  statistics  are  generated  would  be 

012316  - 013315 
013316  - 014315 
014316  - 015315 

The  user  may  wish  to  provide  RPTINT=012300  such  that  the 
default  intervals  are 

012300  - 013359 
013300  - 014359 
014300  - 015359  etc. 

2.2.3.1.12  TIMSPAN=MMDDYY , HHMMSS,  MMDDYY , HHMMSS 


The  Time  span  (TIMSPAN)  keyword  specifies  the  time  period  to  be  covered 
by  the  report.  Only  messages  that  fall  into  the  time  span  range  will 
be  used  to  produce  the  report.  Timespan  is  not  valid  for  I0L0G  and 
L0GC0MP  reports. 


2.2.3.1.13  TERM  $ (required) 

Each  report  request  must  terminate  with  a 'TERM  $'  card. 


2. 2. 3. 2 Data  Cards 

There  are  no  data  cards  to  be  supplied  to  this  program. 
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2.2. 3. 3 Data  Sets 


The  following  input  data  sets  are  required  for  successful  operation  of 
ALQRPT : 

• If  no  sorting  is  to  be  done 

a.  The  partitioned  data  set  containing  the  error  messages 

b.  The  sequential  set  containing  filtered  ALQ  data 

c.  The  control  card  set 

• If  sorting  is  to  be  done 

a.  The  partitioned  data  set  containing  the  error  messages 

b.  The  sequential  set  containing  the  filtered  ALQ  data 
( DDNAME=AAAAIN ) 

c.  The  control  card  set 

d.  The  sort  program  library  data  set  - SYS1.S0RTLIB 

e.  If  report  is  LOGCOMP,  a second  sequential  set  containing 
filtered  ALQ  data  ( DDNAME=BBBBIN ) 

The  DDNAMES  for  these  data  sets  are  defined  on  the  program  control  cards: 

• ERRIN  = er^or  message  set  DDNAME 

• ALQIN  (or  ALQIN1 ) = AAAAIN  (for  sort)  filtered  ALQ  set 

• ALQIN2  = second  filtered  ALQ  set  (BBBBIN) 

The  DDNAME  for  the  sort  library  must  be  SORTLIB.  The  DDNAME  for  the 
control  card  set  must  be  SYSIN. 

The  format  of  these  data  sets  is  described  below: 


DATA  SET 

LRECL 

BLKSIZE 

RECFM 

DSORG 

ERROR  MESSAGES 

80 

80 

F 

PO 

ALQ  INPUT 

512 

512 

F 

PS 

CONTROL  CARDS 

80 

80 

F 

PS 
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2. 2. 3. 4 Job  Control  Language 


The  following  is  the  Job  Control  Language  (JCL)  for  executing  ALQRPT. 
//  JOB  CARD 

//  EXEC  PGM= ALQRPT ,REGI0N=300K 

//STEPLIB  DD  DSN=RA. LIB. PROD. LOAD, DISP=SHR 

//RAERROR  DD  DSN=SPCX. LIB. ERROR. CURRENT, DISP=SHR 

//REPOUT  DD  SYSOUT=A,DCB=( LRECL=133 ,BLKSIZE=1330 ,RECFM=FBA) 

//RAUT1  DD  DSN= SCRATCH, UNIT=SYSDA ,DISP= ( .DELETE ) 

//  SPACE= ( TRK , 5 ) , DCB= ( BLKSIZE=  512 ,RECFM=F, DSORG=DA ) 

//SORTLIB  DD  DSN=SYS1.S0RTLIB,DISP=SHR 

//SORTIN  DD  DSN=ALQ1. INPUT, UNIT=2400,VOL=SER*tape  ID, 

//  DISP=0LD,DCB=(RECFM=F,LRECL=512,BLKSIZE=512),LABEL=(1,NL) 
//S0RTWK01  DD  UNIT=SYSDA, SPACE=(TRK, (25, 10) , .CONTIG) ,DSN=8SYSUT1 
//S0RTWK02  DD  UNIT=SYSDA ,SPACE= (TRK, (25 ,10 ), .CONTIG) ,DSN=8SYSUT2 
//S0RTWK03  DD  UNIT=SYSDA,SPACE=(TRK , (25 ,10 ), .CONTIG) ,DSN=8SYSUT3 
//SORTOUT  DD  DSN=8S0RT0UT,UNIT=SYSDA,DISP=( .PASS) , 

//  SPACE= ( TRK , 50 ) , DCB= ( RECL=  512 ,BLKSIZE=  512 ,RECFM=F ) 

//ALQBIN  DD  DSN=ALQ2 . INPUT ,UNIT=2400 ,VOL=SER=tape  ID, 

//  DISP=OLD, DCB=(RECFM=r ,LRECL=512 ,BLKSIZE=512 ) 

//ALQBWK01  DD  UNIT=SYSDA ,SPACE=(TRK, (25 ,10) , .CONTIG) ,DSN=8ALQB1 
//ALQBWK02  DD  UNIT=SYSDA, SPACE=(TRK, (25, 10) , .CONTIG) ,DSN=8ALQB2 
//ALQBWK03  DD  UNIT=SYSDA, SPACE=(TRK, (25, 10) , .CONTIG) ,DSN=8ALQB3 
//ALQBOUT  DD  DSN=8ALQBOUT,UNIT=SYSDA,DISP=( .PASS) , 

//  SPACE= (TRK, 50 ) ,DCB=(LRECL=512 ,BLKSIZE=512 ,RECFM=F ) 

//SYSOUT  DD  SYS0UT=A 
//SYS IN  DD 
START  $ 

input  control  cards 
TERM  $ 

/* 

// 

This  is  the  full  set  of  JCL  that  may  be  used  to  generate  any  of  the 


reports . 


The  following  criteria  may  be  used  to  reduce  the  number  of  JCL  cards  for 
specific  report  requests: 

• RAUT1  is  a required  DD  card  only  if  REP0RT=L0GC0MP.  If 
REP0RT=L0GC0MP,  then  RAUT1  must  specify  a work  data  set  with 
direct  access  organization. 

• The  SORTLIB  through  SYSOUT  DD  cards  are  required  only  if  a sort 
is  to  be  done  on  two  input  files.  That  is,  all  cards  are 
required  only  if  REPORT=LOGCOMP. 


• Any  report,  other'  than  LOGCOMP,  requires  at  most  only  one 
file  to  be  sorted.  It  the  report  is  not  LOGCOMP,  the  DD  cards 
ALQBIN  through  ALQBOUT  may  be  eliminated. 

• All  sort  related  DD  cards  (SORTLIB  through  SYSOUT)  may  be 
eliminated  if  the  user  is  not  requesting  a sort  (via  the 
control  card  SORT=)  and  if  REPORT  is  not  LOGCOMP  and  if 
REPORT  is  not  RT5UM  with  the  RPTINT  keyword  specified. 


2. 2. 3. 5 Input  Examples 

1.  Generate  a listing  of  the  input  and  output  messages  from  a filtered 
ALQ  tape. 

//  EXEC  PGM=ALQRPT ,REGION=250K 
//STEPLIB  DD  DSN=RA. LIB. PROD. LOAD, DISP=SHR 
//RAERROR  DD  DSN=SPCX . LIB . ERROR . CURRENT ,DISP=SHR 
//SYSPRINT  DD  SYS0UT=A,DCB=BLKSIZE=1330 

//REPOUT  DD  SYSOUT=A,DCB=(LRECL=133,BLKSIZE=1330,RECFM=FBA) 

//ALQIN1  dd  DSN=6ALQIN,UNIT=2400,V0L=SER=tape  ID, 

//  DISP=OLD,DCB= ( RECFM=FB ,LRECL=512 ,BLKSIZE=512 ) , 

//  LABEL=( ,NL) 

//SYSIN  DD  * 

START  $ 

REPORT=IOLOG ; ALQIN=ALQIN1  $ 

ERRIN=RAERROR;CNTLST= SYSPRINT ;RPTLST=REPOUT$$ 

TERM  $ 

2.  The  following  shows  the  mechanism  for  generating  all  reports  from 

the  same  input  ALQ  file.  The  reports  generated  are  shown  in 

Figures  2-1  through  2-6. 

//GO  EXEC  PGM-ALQRPT ,REGI0N=2S0K 
//STEPLIB  DD  DSN=RA. LIB. PROD. LOAD, DISP=SHR 
//SYSERROR  DD  DSN=SPCX. LIB . ERROR. CURRENT ,DISP=SHR 
//SYSPRINT  DD  SYS0UT=A ,DCB=BLKSIZE=1330 

//REPOUT  DD  SYSOUT= A ,DCB= ( LRECL= 133 ,BLKSTZE=1 330,RECFM=FBA) 

/ /RAUT1  DD  DSN=6SCRATCH,UNIT=SYSDA,DISP=( .DELETE) 

//  SPACE=  (TRK. , 5 ) ,DCB= ( BLKSIZE= SI 2 ,RECFM=F , DSORG=DA ) 

//SORTIN  DD  DSN=RA. ALQ. DATA . OUT ,DISP=SHR ,UNIT=2400 ,VOL=SER=CFXXXX , 
//  LABEL= ( ,NL) ,DCB= ( RECFM= FB ,LRECL=512 ,BI.KSIZE= S12 ) 

/ /S0RTWK01  DD  UNIT=SYSDA  ,SPACE=(TRK  ,75 , 1 ) , ,CONTIG)  ,DPN  = f.SYSUTl 
//S0RTWK02  DD  UNIT=SYSDA ,SPACE= (TRK ,75 , 1 ) , .CONTIG) ,DSN=6SYSUT2 
//SORTWK03  DD  UNIT=SYSDA , SPACE = ( TRK ,75,1 ) , , CONTIG) ,DSN=SSYSUT3 
//SORTLIB  DD  DSN=SYS1 . SORTLIB ,DISP=SHR 
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//SORTOUT  DD  DSN=£SORTOUT,UNIT=SYSDA,DISP=( .PASS) , 

//  SPACE=(TRK,400),DCB=(LRECL5512,BLKSIZE5512,RECFM5FB) 

//TESTIN  DD  DSN=RA.ALQ. DATA. TWO, DISP=SHR,UNIT=2400,VOL=SER5CrAAAA, 
//  LABEL5 ( ,NL),DCB5(RECFM=rB,LRECL551?,BLKSIZE5512) 

//TESTWKOl  DD  UNIT=SYSDA, SPACE=(TRK, 75, 1) , .CONTIG)  ,DSN=(.TSTUT1 
//TESTWK02  DD  UNIT=SYSDA , SPACE5 (TRK, ( 75 ,1 ) , .CONTIG) ,DSN=6TSTUT2 
/ /TESTWK03  DD  UNIT=5YSDA .SPACE5 (TRK, ( 75 ,1 ), .CONTIG ) ,DSN=6TSTUT3 
//TESTOUT  DD  DSN=5TESTOUT ,UNIT=SYSDA,DISP5( .PASS) , 

//  SPACE5 ( TRK, 400 ) ,DCB=( LRECL=512  ,BLKSIZE=512  ,RECFM=FB ) 

//SYSOUT  DD  SYSOUT5A 
//SYSIN  DD  * 

START  ; 

REPORT  5 RTSUM  ; 

ERRlN  = SYSERROR  ; CNTI.ST  = SYSPRINT  ; 

SORT  = MSGTYPL  ; 

SORT  5 DEST  ; 

RPTLST  = REPOUT  ; 

TIMINT  5 000100  ; 

ALQIN  5 SORTIN  ; 

TERM  $ 

START  ; 

REPORT  = IOLOG  ; 

ERRIN  = SYSERROR  ; CNTLST  = SYSPRINT  ; 

SORT  5 MSGTYPL  ; 

SORT  = DEST  ; 

RPTLST  5 REPOUT  ; 

ALQIN  5 SORTIN  ; 

TERM  $ 

START  ; 

REPORT  5 IOSUM  ; 

ERRIN  5 SYSERROR  ; CNTLST  = SYSPRINT  ; 

SORT  5 MSGTYPE  ; 

SORT  = DEST  ; 

RPTLST  5 REPOUT  ; 

TIMINT  = 000100  ; 

ALQIN  = SORTIN  ; 

TERM  $ 

START  ; 

REPORT  5 IOSTAT  ; 

ERRIN  = SYSERROR  ; CNTLST  = SYSPRINT  ; 

SORT  5 MSGTYPE  ; 

SORT  5 DEST  ; 

RPTLST  5 REPOUT  ; 

TIMINT  = 000100  ; 

ALQIN  = SORTIN  ; 

TERM  $ 

START  ; 

REPORT  5 LOGCOMP  ; 

ERRIN  5 SYSERROR  ; CNTLST  = SYSPRINT  ; 
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RPTLST  = REPOUT  ; 
ALQIN1  = SORTIN  ; 

ALQIN2  = TESTIN  ; 
TERM  $ 

//SYSUDUMP  DD  SYSOUT=A 


2.2.4  Program  Outputs 

There  are  two  data  sets  output  by  ALQRPT : 

o A sequential  data  set  containing  control  card  images  and 
appropriate  error  diagnostics, 
e A sequential  data  set  containing  the  requested  report 


The  DDNAMEs  for  the  output  data  sets  are  specified  as  control  card 

parameters  and  are  required  for  successful  program  operation: 

• CNTLST  = DDNAME  of  print  file  for  control  card  images  and 
error  diagnostics 

e RPTLST  = DDNAME  of  data  set  to  which  the  report  is  written 

The  format  of  the  data  sets  is  described  below: 


DATA  SET 

LRECL 

BLKSIZE 

RECFM 

DSORG 

PRINT  file 

133 

1330 

FBA 

PS 

REPORT  file 

133 

1330 

FBA 

PS 

If  a sort  is 

to  be  done,  a 

third  output  data  set 

is  required 

for  the 

SORT  utility.  It  must  be  specified  with  the  DDNAME  SYSOUT. 


2. 2. 4.1  Diagnostics 


Diagnostics  generated  by  ALQRPT  fall  into  three  categories: 

• User  abend  codes 

• Error  messages 

• I/O  module  messages 

The  following  user  abends  may  occur: 

USER  0001 

Meaning : The  attempt  to  open  the  SYSIN  file  containing  the  control 
cards  was  unsuccessful.  The  probable  cause  is  that  the  DDNAME 
SYSIN  was  not  provided  in  the  JCL. 

USER  0002 

Meaning:  A serious  error  occurred  during  processing.  The  probable 
cause  is  an  I/O  error  on  an  input  or  output  file.  Refer  to  the 
associated  message  on  the  HASP  output  log  or  in  the  sort  printout. 

USER  0003 

Meaning:  No  valid  control  card  set  was  found  on  the  SYSIN  file. 
Verify  the  control  card  input  for  accuracy, 

USER  0004 

Meaning : The  error  message  data  set  could  not  be  opened  or  its 
DDNAME  was  not  supplied  as  a control  card  parameter.  Verify  that  the 
control  card  ERRIN=DDNAME  of  error  message  set  is  present  in  the 
control  card  set. 
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USER  0005 
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Meaning:  A serious  error  occurred  while  parsing  the  control  cards. 

An  end-of-file  was  encountered  on  the  SYSIN  file  prior  to  encountering 
a TERM  $ control  card  or  an  I/O  error  occurred  while  scanning  SYSIN. 
The  following  are  error  messages  which  may  be  printed  and  the  condition 
indicated  caused  program  termination. 

MESSAGE : RA001  INVALID  CHARACTER  IN  CONTROL  CARD  FIELD 

Meaning:  An  unacceptable  non-alphanumeric  character  was  encountered . 

on  a control  card.  Compool  table  BH  contains  the  valid  special 

characters. 


MESSAGE:  RA002  FIELD  LENGTH  EXCEEDS  EIGHT  CHARACTERS 

Meaning:  A control  card  keyword  or  keyword  parameter  was  found  to 

be  greater  than  8 character  in  length. 


MESSAGE:  RA003  MISSING  OR  INVALID  CONTROL  CARD  KEYWORD 

Meaning : An  acceptable  control  card  keyword  was  not  encountered  at 

the  onset  of  a keyword  expression.  The  intended  keyword  is  either 

misspelled  or  has  been  omitted.  The  following  keywords  are  acceptable: 

ALQIN  ERRIN 

CNTLST  REPORT 

DBIN1  RPTLST 

DBIN2  START 

ENDTIM  TERM 

ENDDAT  TIMINT 

TIMSPAN 
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MESSAGE : RA004  MISSING  OR  INVALID  VALUE  - XXXX  EXPECTED 

Meaning:  An  equal  sign  or  other  delimiter  was  not  encountered  at 
the  appropriate  point  in  the  keyword  expression.  XXXX  equals  the 
expected  value. 
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MESSAGE:  RA005  INVALID  TIME/DATE  ENTRY 


Meaning:  A portion  of  the  time/date  field  includes  an  out  of  range 
value,  a field  is  not  6 digits,  or  the  time/date  entries  do  not 
represent  a time  range. 

MESSAGE : RA007  TOO  MANY  IDENTIFIERS  FOR  KEYWORD 

Meaning:  The  maximum  allowable  number  of  parameters  for  a particular 
keyword  has  been  exceeded.  Compool  table  15  contains  the  maximum 
values  for  associated  keywords. 

MESSAGE : RA008  INVALID  IDENTIFIER  IN  DESTINATION  FIELD 

Meaning:  Appropriate  keyword  parameters  were  not  found  following  a 

valid  keyword  in  the  control  card  set. 

MESSAGE : RA009  INVALID  PARAMETER  FOR  THIS  REPORT  - XXXXXX 

Meaning:  The  parameter  indicated  is  an  invalid  keyword  for  the 
report  requested. 

MESSAGE:  RA010  CNTLST  AND/OR  ERRIN  FILE(S)  NOT  OPENED  FOR  PRIOR 
REPORT(S) 

Meaning : For  multiple  report  requests  in  one  control  card  set,  the 
indicated  keywords  designating  the  print  file  and  error  message  file 
were  not  found  with  the  prior  report  requests.  The  current  report 
will  be  generated;  the  prior  reports  requested  will  not  be  generated. 

MESSAGE:  RA011  - DURING  LOGCOMF  EOF  ON  ALQn  WITHOUT  MATCHING 
EOF  ON  ALQn 

Meaning:  During  execution  of  a LOG  COMPARE  request,  end  of  file  was 
reached  on  one  filtered  ALQ  file  without  a matching  end  of  file  on  the 
other  filtered  ALQ  file. 
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MESSAGE : RA013  - MORI  THAN  10  RECORDS  READ  ON  ALQn  AFTER  EOF 

ON  ALQn 

Meaning : During  execution  of  a LOG  COMPARE  request,  an  end  of  file 
was  reached  on  one  of  the  two  filtered  ALQ  files.  After  printing 
ten  messages,  end  of  file  had  not  been  reached. 

After  this  message  is  printed,  LOG  COMPARE  statistics  are  printed 
and  LOG  COMPARE  processing  is  terminated. 

MESSAGE:  RA012  - FOR  REPORT  XXXXXXXX  TOO  MANY  ACCUMULATORS  REQUIRED 
Meaning:  During  processing  of  IOSTAT,  IOSUM,  or  RTSUM,  an  entry 
time  (IOSUM,  IOSTAT)  or  a response  time  (RTSUM)  fell  out  of  the 
range  of  the  accumulators. 

The  last  accumulator  will  be  incremented  and  processing  will  continue. 

This  may  be  corrected  by  specifying  a larger  time  interval. 

The  following  are  I/O  module  messages  which  appear  on  the  HASP  log.  In 
all  cases,  an  I/O  error  will  result  in  program  termination. 

MESSAGE : AAAAAAAA  ERROR  ON  OPEN 

Meaning : The  data  set  associated  with  the  DDNAME  (AAAAAAAA)  could 
not  be  opened.  The  probable  cause  is  that  the  DDNAME  indicated 
was  not  provided  in  the  JCL. 

(J 

MESSAGE:  AAAAAAAA  GIVES  TOO  MANY  PDS  FILES 

Meaning:  The  maximum  number  of  partitioned  data  sets  that  may  be 
open  at  any  one  time  is  5.  AAAAAAAA  is  the  DDNAME  of  the  file  to 
be  opened  when  the  limit  was  exceeded. 
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MESSAGE:  AAAAAAAA  GIVES  TOO  MANY  I/O  FILES 


Meaning : The  maximum  number  of  I/O  data  sets  that  may  be  open  at 
any  one  time  is  20.  AAAAAAAA  is  the  DDNAME  of  the  data  set  to  be 
opened  when  the  limit  was  exceeded. 

MESSAGE : AAAAAAAA  IS  UNABLE  TO  GET  SUFFICIENT  CORE  FOR  DCB 
Meaning:  There  was  insufficient  core  available  when  the  data  set 
specified  by  the  DDNAME  (AAAAAAAA)  indicated  was  to  be  opened. 
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2.3  System  Analysis  Recording  (SAR)  Dump  Program  (SARDMP) 

2.3.1  General  Program  Description 

The  System  Analysis  Recording  Dump  Program  (SARDMP)  selects  records  from 
SAR  tapes  and  prints  the  selected  records  in  hexadecimal  format.  Records 
to  be  printed  may  be  selected  by  time  interval  and  record  category.  A 
summary  of  the  total  number  of  records  found  for  each  record  category 
is  also  printed. 

SAR  tapes  contain  data  used  in  systems  analysis  and  evaluation,  which  has 
been  transferred  from  core  storage  to  magnetic  tape  during  operation  of 
the  CFC  Monitor  or  NAS  Model  3 Systems  (ref:  NAS  Monitor  Handbook). 

2.3.2  Program  Operation 

SARDMP  reads  the  input  SAR  data  set  and  writes  selected  records  in  hexa- 
decimal format  to  an  output  print  file.  SARDMP  is  capable  of  processing 
a SAR  data  set  contained  in  multiple  tape  volumes.  If  multiple  tape 
volumes  are  specified,  the  program  expects  that  the  volumes  were  created 
contiguously.  If  the  volumes  are  not  contiguous,  individual  program 
processing  of  each  tape  is  necessary.  This  constraint  is  due  to  the 
segmentation  of  SAR  tape  records . 

The  user  specifies  the  time  interval  as:  beginning  and  ending  time, 
beginning  time  only  (causing  records  with  beginning  time  equal  to  or 
greater  than  specified  beginning  to  be  selected),  or  indicates  that  there 
is  no  time  constraint  (ref:  Sec.  2. 3. 3. 1.1  Time  Card). 

All  data  loss  or  startover  records  encountered  on  the  input  SAR  set  are 
printed  regardless  of  time  they  occurred.  All  other  types  of  records  are 
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subject  to  selection  by  time  interval,  if  specified,  and  to  selection  by 
record  category.  Selection  by  record  category  allows  selection  by 
recording  code  or  selection  of  Timing  Analysis  (TAR)  records. 


The  user  may  filter  SAR  records  by  recording  codes  and  further  by  program 
ID  (within  recording  code)  if  desired. 

If  user  filters  on  TAR  records,  no  other  type  of  record  may  be  specified, 
i.e.,  no  recording  codes  may  be  specified.  TAR  records  may  be  filtered 
further  only  by  time  interval. 

2.3.3  Program  Inputs 
2. 3. 3.1  Control  Cards 

The  control  cards  are  free  format;  any  number  of  cards  may  be  specified. 
The  following  rules  govern  the  control  card  format : 

• A dollar  sign  ($)  indicates  the  end  of  control  information 
on  a given  card 

• Multiple  control  card  keywords  with  the  associated  parameters 
may  appear  on  a single  card 
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• A semicolon  ( ; ) is  used  to  separate  control  card  keyword 
parameters  from  the  next  keyword 

• Control  cards  may  contain  information  in  columns  1 through  72 
inclusive 

• Lists  of  keyword  parameters  are  separated  by  commas 

• No  keyword  may  be  duplicated  within  a control  card  set 
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• Blanks  may  appear  anywhere  on  a control  card.  However,  since 
a blank  may  signal  the  end  of  a field  (e.g.,  keyword  or 

keyword  parameter),  a blank  should  not  be  embedded  within  a field, 

• A control  card  field  may  be  one  to  eight  characters  in  length 

• A continuation  sign  (+)  may  follow  either  a semicolon  ( ; ) or 
a comma  (,).  This  sign  signals  that  no  further  information 
follows  on  the  current  card  but  that  the  stream  of  information 
is  continued  on  the  following  card. 

2. 3. 3 .1.1  TIME  Card 

There  must  be  one  and  only  one  time  card,  and  it  must  be  the  first  card. 

The  formats  are  as  follows : 

TIME=beginning  time,  ending  time  $ 

Times  are  six  digits  specifying  the  time  elapsed  since 
midnight  as  HHMMSS  (hours,  minutes,  seconds). 

TIME=beginning  time  $ 

The  beginning  time  is  in  the  format  described  above.  This 
time  frame  consists  of  all  times  greater  than  or  equal  to 
the  beginning  time. 

TIME=ALL  $ 

There  are  to  be  no  time  constraints. 

2.3. 3.1. 2 RCODE  Card 
RCODE=recording  code  $ 

Recording  codes  are  integers  between  0 and  255.  Any  combination 
of  these  cards  may  be  used  in  a given  run. 
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RCODE=recording  code,  PEID1,  PEID2 . . . PEID10  $ 

Up  to  ten  program  elements  (PEs)  may  further  qualify  a 
recording  code.  PE  IDs  are  integers  between  0 and  255.  Records 
with  this  recording  code  will  not  be  printed  unless  they  were 
created  by  one  of  the  PE  IDs  specified.  Up  to  50  of  these 

[ 

cards  may  be  included  in  a given  run. 

RC0DE=TAR  $ 

Only  TAR  records  are  to  be  printed.  If  this  card  is  used, 
it  must  be  the  only  recording  code  card. 

RC0DE=ALL  $ 

All  records  other  than  TAR  records  are  to  be  printed.  If 
this  card  is  used,  it  must  be  the  only  recording  code  card. 

2. 3. 3. 2 Data  Cards 

There  are  no  data  cards  to  be  supplied  to  this  program. 

2. 3. 3. 3 Data  Sets 

Three  input  data  sets  are  required  for  successful  operation  of  SARDMP: 

• A sequential  set  containing  the  control  card  information. 

• The  SAR  data  input  as  a sequential  data  set;  the  medium  ex- 
pected is  magnetic  tape;  a data  set  on  multiple  tape  volumes 
may  be  processed  by  specifying  a list  of  volume  serial  numbers 
on  the  same  DD  card  in  the  JCL. 

• The  partitioned  data  set  containing  the  error  messages. 
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The  DDNAMEs  required  for  the  input  files  and  the  data  set  attributes 
are  given  below. 


DATA  SET 

DDNAME 

RECFM 

LRECL 

BLKSIZE 

DSORG 

CONTROL  CARDS 

SYS  IN 

F 

80 

80 

PS 

SAR 

DATAIN 

VB 

10000 

PS 

ERROR  MESSAGES 

ERRIN 

F 

80 

80 

PO 

2. 3. 3. 4 Job  Control  Language 

//  EXEC  PGM=SARDMP,REGI0N=64K 
//STEPLIB  DD  DSN=RA. LIB. PROD. LOAD, DISP=SHR 
//CNTLST  DD  SYSOUT=A, 

//  DCB=(RECFM=FBA,LRECL=133,BLKSIZE=3458) 

//DATAIN  DD  DCB= ( DEN=2 ,R£CFM=U ,BLKSIZE= 10000 ,ER0PT=ACC) , 
//  UNIT=(TAPE,, DEFER), V0L=SER=CF1601,LABEL=( ,BLP) 
//ERRIN  DD  DSN=SPCX. LIB. ERROR. CURRENT, DISP=SHR 
//SYS IN  DD  * 

Control  Card  Set 


NOTE : If  EROPT=ACC  is  specified  in  the  DCB  parameter  of  the  DATAIN 

DD  statement,  and  an  I/O  error  occurs  while  reading  this  file, 
the  SAR  DUMP  program  will  terminate  with  an  error  message 
(no  dump).  A dump  and  other  system  information  will  be 
provided  if  this  subparameter  is  excluded  or  if  it  is 
ER0PT=ABE. 

2. 3. 3. 5 Input  Examples 

Example  1:  The  example  below  will  cause  printing  of  all  non-TAR 
input  recorded  between  two  minutes,  ten  seconds  after  midnight 
and  two  minutes,  fifteen  seconds  after  midnight  (inclusive). 

TIME= 000210, 000215  $ 

RC0DE=ALL  $ 

Example  2 : The  example  below  will  cause  printing  of  all  input  TAR 
records  created  on  or  after  the  twenty  second  hour  past  midnight . 

TIME=220000  $ 

RC0DE=TAR  $ 
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Example  3 : The  example  below  will  cause  printing  ol  all  input 
records  having  a recording  code  of  50,  as  well  as  those  with  a 
recording  code  of  23  created  by  Program  Elements  1 through  5. 


TIME*ALL  $ 

RCODE=SO  $ 

RCODE=23 ,1 ,2 ,3 ,4 ,5  0 

2.3.4  Program  Outputs 

The  only  output  file  from  SARDMP  is  the  report  file.  This  file  contains 
the  control  card  images,  any  error  diagnostics,  the  dump  of  the  re- 
quested data,  and  totals  by  record  type  of  records  printed.  This  file 
must  be  specified  by  the  DDNAME  CNTLST  with  RECTM-EBA , LRECL=133, 
BLKSIZE=3458.  Samples  of  the  output  on  this  file  are  illustrated  in 
Figures  2-7,  2-8,  and  2-9. 
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2. 3. 4.1  Diagnostics 

The  following  are  error  messages  that  may  be  printed  and  the  condition 
indicated  will  cause  program  termination. 

MESSAGE : RA001  INVALID  CHARACTER  IN  CONTROL  CARD  FIELD 

Meaning : An  unacceptable  non-alphanumeric  character  was  encountered 
on  a control  card.  Compool  table  BH  contains  the  valid  special 
characters . 

MESSAGE:  RA002  FIELD  LENGTH  EXCEEDS  EIGHT  CHARACTERS 

Meaning : A control  card  keyword  or  keyword  parameter  was  found 

to  be  greater  than  eight  characters  in  length. 

MESSAGE:  RA003  MISSING  OR  INVALID  CONTROL  CARD  KEYWORD 
Meaning : An  acceptable  control  card  keyword  was  not  encountered 
at  the  onset  of  a keyword  expression.  The  intended  keyword 
is  either  misspelled  or  has  been  omitted. 

MESSAGE:  RA004  MISSING  OR  INVALID  VALUE  - XXXX  EXPECTED 
Meaning:  XXXX  represents  a control  card  parameter  that  was  not 
found. 

MESSAGE:  RA005  INVALID  TIME/DATE  ENTRY 

Meaning : A portion  of  the  time  field  includes  an  out  of  range 
value,  a field  is  not  six  digits,  or  the  entries  do  not  represent 
a valid  time  interval. 
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MESSAGE: 


RA016  RUN  TERMINATED  DUE  TO  READ/WRITE  ERROR  ON  FILE  XXXX 
IN  MODULE  YYYY 


Meaning:  An  uncorrectable  I/O  error  has  caused  the  program  to 
terminate. 


MESSAGE:  RA017  RUN  TERMINATED  DUE  TO  PRESENCE  OF  ERROR(S)  ON 
CONTROL  CARDS 

Meaning : Any  error  found  in  the  control  card  set  causes  termination 
of  run  after  all  cards  have  been  parsed. 


MESSAGE:  RA018  RUN  TERMINATED  DUE  TO  I/O  ERROR  AFTER  CALL  TO 
RAEMSG  FROM  MODULE  XXXX 

Meaning:  RAEMSG  is  the  module  which  is  called  to  write  diagnostics. 
RAEMSG  encountered  an  I/O  error  while  attempting  to  write  the 
diagnostic. 


MESSAGE:  RA019  RUN  TERMINATED  DUE  TO  I/O  ERROR  AFTER  CALL  TO 
RALSTC  FROM  MODULE  XXXX 

Meaning:  RALSTC  is  the  module  which  is  called  to  print  control 
card  images. 

MESSAGE:  RA020  RUN  TERMINATED  DUE  TO  ILLOGICAL  LENGTH  DESCRIPTOR 
ON  SAR  RECORD  BELOW 

Meaning : A SAR  input  record  not  in  NOSS  variable  length  format 
(other  than  tape  header)  has  been  encountered.  This  message  is 
preceded  by  RA032  and  a dump  of  the  first  80  bytes  of  the  record. 


MESSAGE : RA021  RUN  TERMINATED:  THE  CURRENT  TAPE  BEGINS  LATER  THAN 

THE  ENDING  TIME  PARAMETER 


Meaning:  The  ending  time  parameter  referred  to  came  from  control 
card  input. 


MESSAGE : RA022  NO  CONTROL  CARLS  POUND  IN  INPUT  STREAM 

Meaning:  TIME  and  RCODE  are  required  control  cards. 


MESSAGE:  RA023  THE  FIRST  SEGMENT  BELOW  IS  NEITHER  A COMPLETE 
OR  INITIAL  SEGMENT 

Meaning:  A middle  or  terminal  SAR  input  record  segment  has  been 
encountered  without  the  preceding  initial  segment. 


MESSAGE : RA024  DATA  LOSS  RECORD  ENCOUNTERED  (PRINTED  BELOW) 

Meaning:  A SAR  data  loss  input  record  has  been  encountered. 


MESSAGE : RA025  STARTOVER  RECORD  ENCOUNTERED  (PRINTED  BELOW) 

Meaning:  A SAR  startover  input  record  has  been  encountered. 


MESSAGE : RA026  PE  ID  INVALID;  TOO  MANY  PE  IDS  OR  INVALID  NUMBER 

Meaning:  More  than  10  PE  IDs  per  recording  code  was  specified  or 
an  invalid  PE  ID  was  specified. 


MESSAGE:  RA027  TAR  SPECIFIED  ON  OTHER  THAN  SECOND  CARD 
Meaning:  The  keyword  parameter  "TAR"  is  valid  only  on  the  second 
control  card. 


MESSAGE : RA028  RECORDING  CODE  ERROR.  DUPLICATE  OR  TABLE  OVERFLOW 

Meaning:  A duplicate  recording  code  was  specified  or  more  than  50 
recording  codes  were  specified. 

MESSAGE:  RA029  INVALID  CARD.  PRIOR  CARD  INDICATED  NO  MORE  CARDS 
Meaning:  An  extra  control  card  was  encountered.  Either  TIME=ALL 

or  RC0DE=ALL  was  found  followed  by  another  TIME  or  RCODE  request 
or  RC0DE=TAR  was  specified  followed  by  additional  RCODE  requests. 
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MESSAGE: 


RA030  THE  RECORD  ABOVE  IS  INCOMPLETE;  ITS  TERMINAL 
SEGMENT  WAS  NOT  IN  SEQUENCE 

Meaning : This  refers  to  SAR  input;  an  incomplete  record  was  found. 

MESSAGE:  RA031  ALL  SPECIEIED  ON  OTHER  THAN  FIRST  OR  SECOND  CARD 
Meaning:  The  keyword  parameter  "ALL"  is  valid  only  on  the  first 
and  second  control  cards. 

MESSAGE:  RA032  THE  FIRST  80  BYTES  OF  A BAD  RECORD  ARE  PRINTED 
BELOW:  BLOCK  XXX  RECORD  YYY 

Meaning : A SAR  input  record  is  not  in  the  NOSS  variable  length 
format.  The  block  and  record  numbers  are  inserted;  however,  they 
cannot  be  guaranteed  to  be  exact  due  to  the  fact  that  VGETR,  a 
JOVIAL  library  routine,  is  used  to  read  and  deblock  the  input. 

The  block  number  is  either  correct  or  one  less  than  the  correct 
number . 

MESSAGE:  NO  RECORDING  CODES  FOUND  IN  INPUT  STREAM 
Meaning:  RCODE  is  a required  control  card. 
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2.4  Data  Base  Analysis  Program  (DBANAL) 

2.4.1  General  Program  Description 

The  Data  Base  Analysis  (DBANAL)  Program  performs  off-line  analysis  of 
the  CFC  Data  Base.  The  functions  performed  by  the  DBANAL  program  include: 

• Off-line  re-creation  of  the  CFC  Data  Base  to  any  point  in  time 
using  a data  base  backup  tape  and  its  associated  recovery  tapes. 

• Calculation  of  flight  record  statistics  for  both  the  OAG 
and  Non-OAG  Flight  Record  Sets,  including  total  number  of 
records  by  arrival  terminal,  departure  terminal,  arrival/ 
departure  pair,  and  calculations  of  percent  of  physical 
block  usage. 

• Comparison  of  two  OAG  Flight  Record  Sets  and  two  Non-OAG 
Flight  Record  Sets  showing  total  number  of  matched  records, 
number  of  mis-matched  records,  and  number  of  no-match  records. 

• A listing  of  Data  Base  statistic  records  from  a filtered  ALQ 
set  showing  the  statistics  records  generated  for  each  input 
CFC  message. 

• A summary  of  data  base  statistics  on  table  usage  by  retrieval 
method  and  access  type. 

• A statistical  summary  of  data  base  lock  usage  giving  the  number 
of  locks  and  length  of  locks  for  a specified  time  interval. 

The  DBANAL  program  can  generate  any  number  of  these  reports  during  one 
execution. 

2.4.2  Program  Operation 

The  DBANAL  program  begins  by  reading  user-supplied  control  cards  from  the 
SYSIN  file.  The  control  cards  contain  the  DDNAMES  of  the  input  and  output 
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files  and  the  report  request  information.  The  required  modules  are 
then  invoked  to  produce  the  requested  report.  The  Data  Base  Analysis 
Program  produces  the  following: 


a.  Start-Up  Data  Base.  The  Data  Base  Backup  tape  set  is  read  and 
an  off-line  copy  of  all  data  base  sets  is  created.  The  associated  recovery 
tapes  are  then  read  and  the  updates  are  applied  to  the  off-line  sets. 

The  user  may  specify  a time  parameter  which  is  applied  to  the  update 
process.  Only  those  recovery  records  that  contain  a time  less  than  the 
user-specif led  time  are  applied. 

b.  Flight  Record  Statistics  Report.  The  Start-Up  Data  Base  function 
described  above  is  first  invoked  to  create  off-line  the  Flight  Record  Sets 
(OAG  and  Non-OAG)  to  be  analyzed.  The  OAG  Flight  Record  Set  is  first 
opened  and  each  physical  block  is  read.  The  arrival  terminal,  departure 
terminal,  and  number  of  active  slots  is  retrieved  from  each  block  header 
and  stored.  The  stored  information  is  then  sorted  to  produce  statistics 

by  arrival  terminal,  departure  terminal,  and  arrival  departure  pairs. 

The  Non-OAG  Flight  Record  Set  is  then  processed  in  the  same  manner  and 
the  report  is  generated.  Figure  2-10  is  a sample  output  for  this  report. 

c.  Flight  Record  Set  Comparison  Report.  The  Start-Up  Data  Base 
function  described  above  is  first  invoked  to  create  the  Flight  Record 
Sets  (OAG  and  Non-OAG).  The  OAG  Flight  Record  Set  is  opened  and  each 
logical  flight  record  is  read  and  written  to  a work  data  set.  The 
Non-OAG  set  is  then  opened  and  each  logical  flight  record  is  read  and 
written  to  a second  work  data  set.  The  Start-Up  Data  Base  function  is 
then  invoked  a second  time  to  create  off-line  the  second  copy  of  the  Flight 
Record  Sets  (OAG  and  Non-OAG).  A third  and  fourth  work  data  set  are  then 
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created  containing  the  flight  records  from  second  copy.  The  four  work 
data  sets  are  then  sorted  by  arrival  terminal,  departure  terminal,  air- 
craft identification,  and  departure  time.  The  two  OAG  sets  are  then 
compared  followed  by  a comparison  of  the  two  Non-OAG  sets . A report  on 
the  total  number  of  matched  records,  mis-matched,  and  no-match  records  is 
generated  for  both  the  OAG  comparison  and  the  Non-OAG  comparison.  Mis- 
matched and  no-match  records  are  printed.  A match  results  if  all  fields 
in  the  two  records  are  identical.  A mis-match  occurs  if  the  two  records 
contain  the  same  arrival  terminal,  departure  terminal,  aircraft  identifi- 
cation, and  departure  time,  but  differ  in  any  other  field.  A no-match 
occurs  if  no  record  exists  containing  the  same  arrival  terminal,  departure 
terminal,  aircraft  identification,  and  departure  time.  Figure  2-11  is 
a sample  output  for  this  report. 

d.  Data  Base  Statistics  Log  Report.  This  report  provides  a listing 
of  Data  Base  statistics  records  from  a filtered  ALQ  set  (ref:  Section  2.1). 
Data  Base  statistics  records  are  extracted  from  the  filtered  ALQ  set, 
formatted,  and  written  to  the  output  set.  Figure  2-12  is  sample  output 

for  this  report. 

e.  Data  Base  Statistics  Summary  Report.  The  input  filtered  ALQ 
set  is  read.  Each  Data  Base  statistic  record  encountered  is  deblocked 
into  logical  components  identified  by  type  of  data  base  access  (flight 
record  retrieval,  get  next  flight  record  retrieval,  or  table  retrieval). 
These  component  records  are  written  to  a work  data  set  for  sorting  by 
table  accessed,  type  of  access,  and  retrieval  method.  Statistics  are 
generated  for  each  table  accessed  and  the  report  is  written.  Figure  2-13 
is  sample  output  for  this  report. 
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Figure  2-11.  Flight  Record  Set  Comparison  Report  (3  of  3) 
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FIGURE  2-13  Data  Base  Statistics  Summary  Report 
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Data  Base  Lock  Queue  Statistics  Report.  The  input  filtered 


f. 

ALQ  set  is  read  and  each  Data  Base  statistic  record  encountered  is  de- 
blocked into  logical  components.  The  lock  queue  components  are  written 
to  a work  data  set  for  sorting  by  time.  A histogram  indicating  the 
number  and  type  of  data  base  lock  for  specified  time  intervals  is 
generated.  Figure  2-14  is  sample  output  for  this  report. 

2.4.3  Program  Inputs 
2.4. 3.1  Control  Cards 

The  control  cards  are  free  format;  any  number  of  cards  may  be  specified. 
The  following  rules  govern  the  control  card  format : 

• A dollar  sign  ($)  indicates  the  end  of  control  information 
on  a given  card. 

• Multiple  control  card  keywords  with  the  associated  parameters 
may  appear  on  a single  card. 

• A semicolon  ( ; ) is  used  to  separate  control  card  keyword 
parameters  from  the  next  keyword. 

• Control  cards  should  be  included  between  a 'START  $'  card  and 

a 'TERM  $'  card;  the  'START  $'  card  is  optional;  the  TERM  $ 

card  is  required. 

• Control  cards  may  contain  information  in  columns  1 through  72 
inclusive. 

• Lists  of  keyword  parameters  are  separated  by  commas. 

• No  keyword  may  be  duplicated  within  a control  card  set. 

• Blanks  may  appear  anywhere  on  a control  card.  However,  since  a 

blank  may  signal  the  end  of  a field  (e.g.,  keyword  or  keyword 
parameter),  a blank  should  not  be  embedded  within  a field. 
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• A control  card  field  may  be  one  to  eight  characters  in  length. 

• A continuation  sign  (+)  may  follow  either  a semicolon  (;)  or  a 
comma  (,).  This  sign  signals  that  no  further  information 
follows  on  the  current  card  but  that  the  stream  of  information 
is  continued  on  the  following  card. 

• The  following  control  card  keywords  are  required  for  all  reports: 

CNTLST 

ERRIN 

REPORT 

RPTLST 

TERM 

• The  following  control  card  keywords  are  optional  or  are  report 

dependent : 

START  TIMINT 

DBIN1  TIMSPAN 

DBIN2 

ENDTIM 

ENDDAT 

ALQIN 

No  additional  keywords  will  be  accepted. 


2. 4. 3. 1.1  START  $ (Optional) 

This  card  signals  the  beginning  of  the  control  card  stream. 


2. 4. 3. 1.2  REPORT=AAAAAAAA  $ (Required) 

The  report  keyword  designates  which  function  is  to  be  performed.  The 
possible  functions  are: 


AAAAAAAA 


DBSTUP  (Data  Base  Start-Up  Function) 
FRSTAT  (Flight  Record  Statistics) 

FRCOMP  (Flight  Record  Comparison) 

DBLOG  (Data  Base  Statistics  Log) 

DBSUM  (Data  Base  Statistics  Summary) 
DBLOCK  (Data  Base  Lock  Queue  Statistics) 
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2. 4. 3. 1.3  ERRIN=DDNAME  $ (Required ) 


The  ERRIN  keyword  designates  the  DDNAME  of  the  error  message  file. 

2. 4. 3. 1.4  CNTLST=DDNAME  $ (Required) 

The  CNTLST  keyword  designates  the  DDNAME  of  the  file  to  which  the  control 
card  images  and  any  error  messages  are  to  be  written. 

2. 4. 3. 1.5  RPTLST= DDNAME  $ (Required) 

The  RPTLST  keyword  designates  the  DDNAME  of  an  output  file  to  which  the 
report  is  to  be  written. 

2. 4. 3. 1.6  DBIN1=DDNAME  $ 

The  DBIN1  keyword  designates  the  DDNAME  of  the  input  file  containing  the 
data  base  backup  and  recovery  tapes.  This  keyword  is  required  for  the 
following  reports:  DBSTUP,  FRSTAT,  and  FRCOMP.  It  is  invalid  for  all 
other  reports. 

2. 4. 3. 1.7  DBIN2=DDNAME  $ 

The  DBIN2  keyword  designates  the  DDNAME  of  a second  input  file  containing 
data  base  backup  and  recovery  tapes.  This  keyword  is  required  for  the 
report  FRCOMP.  FRCOMP  will  compare  the  flight  record  sets  unloaded  from 
the  data  base  supplied  by  DBIN1  to  the  flight  record  sets  unloaded  from 
the  data  base  supplied  by  DBIN2 . This  control  keyword  is  invalid  for 
all  other  reports. 

2.4. 3.1. 8 ENDDAT=YYMMDD  $ 

The  ENDDAT  keyword,  in  conjunction  with  the  ENDTIM  keyword,  specifies  stop 
date  and  time  to  be  applied  to  the  data  base  startup  function  (applicable 
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to  reports  DBSTUP,  FRSTAT,  and  FRCOMP).  It  is  optional  for  the  reports 
DBSTUP,  FRSTAT,  and  FRCOMP;  it  is  invalid  for  all  other  report  requests. 
The  format  of  the  control  keyword  is: 


ENDAT=YYMMDD 

where  YY  = ending  year  (i.e.,  7B,  79) 

MM  = ending  month  (i.e.,  01... 12) 

DD  = ending  day  (i.e.,  01... 31) 

2. 4. 3. 1.9  ENDTIM=HHMM 

The  ENDTIM  keyword  in  conjunction  with  the  ENDDAT  keyword  specifies  the 
stop  date  and  time  to  be  applied  to  the  data  base  startup  function.  It 
is  optional  for  the  reports  DBSTUP,  FRSTAT,  and  FRCOMP;  it  is  invalid 
for  all  other  report  requests.  The  format  of  the  control  keyword  is: 
ENDTIM=HHMM 

where  HH  = ending  hour  (i.e.,  00... 23) 

MM  = ending  minute  (i.e.,  00... 59) 

2.4.3.1.10  ALQIN=DDNAME  $ 

The  ALQIN  keyword  specifies  the  DDNAME  of  the  input  ALQ  file  to  be  proc- 
essed when  the  report  request  is  DBLOG,  DBSUM,  or  DBL0CK.  For  the  DBL0G 
report,  the  input  file  must  be  a filtered  ALQ  file  generated  by  the 
ALQFLTR  program.  For  reports  DBSUM  and  DBLOCK,  either  a filtered  or 
unfiltered  ALQ  file  may  be  input.  This  keyword  is  required  when  the 
report  request  is  DBLOG,  DBSUM,  or  DBLOCK;  it  is  invalid  for  all  other 
reports . 

2.4.3.1.11  TIMSPAN=MMDDYY ,HHMMSS ,MMDDYY ,HHMMSS  $ 

The  TIMSPAN  keyword  specifies  the  time  span  to  be  covered  by  the  report. 
All  records  found  outside  the  specified  time  period  are  not  processed. 
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This  keyword  is  optional  for  the  reports  DBSUM  and  DBLOCK.  It  is  invalid 

for  all  other  reports.  The  format  is: 

TIMSPAN=MMDDYY , HHMMSS .MMDDYY ,HHMMSS 

=beginning  date,  beginning  time, 
ending  date,  ending  time 

2.4.  3. 1.12  TIMINT=HHMMSS  $ 

The  TIMINT  keyword  specifies  the  size  of  the  time  interval  for  which 
statistics  are  accumulated  (i.e.  , the  histogram  bin  size).  This  keyword 
is  required  for  reports  DBSUM  and  DBLOCK;  it  is  invalid  for  all  other 
reports. 

2.4.3.1.13  TERM  $ 

The  TERM  keyword  signals  the  end  of  the  report  request  cards.  It  is 
required  for  all  reports. 

2. 4. 3. 2 Data  Cards 

There  are  no  data  cards  to  be  input  to  this  program. 

2. 4. 3. 3 Data  Sets 

Input  data  sets  to  the  DBANAL  program  include: 

• The  control  card  set  as  sequential  input 

• The  partitioned  data  set  containing  the  error  messages 
(ERRIN=DDNAME) 

• The  sequential  set  containing  the  data  base  backup  and 
recovery  tapes 

(for  REPORT=DBSTUP ; DBIN1=DDNAME ) 

(for  REPORT=FRSTAT ; DBIN1=DDNAME) 

(for  REPORT=FRCOMP ; DBIN1=DDNAME) 

• The  sequential  set  containing  a second  set  of  data  base  backup 
and  recovery  tapes  (for  REPORT=FRCOMP ; DBIN2=DDNAME) 


The  sequential  set  containing  ALQ  data 


(lor  KEI'QRT-DBLOG  ; ALQIN=DDNAME ) 
(for  KEPORT=DBSUM ; ALQIN=DDNAME ) 
(for  FJ:PORT=DBLOCK;  ALQIN  = DDNAMi: ) 

The  format  of  these  data  sets  is  described  below: 


DATA  SET 

LRECL 

BLKSIZE 

RECFM 

DSORG 

CONTROL  CARDS 

80 

80 

F 

PS 

ERROR  MESSAGES 

80 

80 

F 

P0 

DATA  BASE  INPUT 
( DBIN1  AND  DBIN2 ) 

- 

U 

PS 

ALQ  INPUT 

512 

512 

F 

PS 

2. 4. 3. 4 Job  Control  Language 

Figure  2-15  is  the  Job  Control  Language  for  executing  DBANAL. 


2. 4. 3. 5 Sample  Illustrations 


The  following  are 

sample  control  card  sets  to  be  used  with  the  JCL 

described  in  Section  2. 4. 3. 4. 

• Request 

Flight  Record  Statistics  Report 

//SYSIN 

DD  * 

START  $ 

REPORT 

= FRSTAT  $ 

ERRIN 

= RAERROR  $ 

CNTLST 

= ERRPRINT  $ 

RPTLST 

= REPRINT  $ 

DBIN1 

= DBASE1  $ 

• 

TERM  $ 

• Request 

Flight  Record  Sets  Comparison  Report 

• 

//SYSIN 

DD  * 

START  $ 

REPORT 

= FRCOMP  $ 

ERRIN 

= RAERROR  $ 

CNTLST 

= ERRPRINT  $ 

RPTLST 

= REPRINT  $ 

DBIN1 

= DBASE1  $ 

DBIN2 

= DBASE2  $ 

TERM  $ 

LL 
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Figure  2-15.  Jl’L.  tor  I'.xecuting  DRANAL 
(1  ot  ft) 


/ /oxo  no  osn="  a .ov . pa r / , o t ^ i nc..  . pass i , (m  t = sy soa, 
f r spacf  = (t.™ , n , i > ) , osb=  i pfc=  " = c , i rfci  = yzo.blksi  zp  = 7->n  j 

//USD  r*n  ..,  S ‘ = P A . ' ■(  S . 1 A t 4,  l(S3:[‘J£'J*F'SS)|i)KIIT  = <>YS'Hi 
//  !,"f',ftijfK,ii.i)),  r“=rr'r"'=rt!  ,cc.i.  - ?2'. . 'flksi  z*=  3?*  f 
//■  S'1  in  cc  .r.  wa. or ss=  nc . , pass) , u ji t=sysda, 

//  SB\'.:=|T3K,(Mi).Jr  :=(  - - , i • =n = n oo,  bikst /r  = n os  ) 

op  os . =p  G . na  t a . > i >°  ( if  . , -v  ss ) ♦ uni  t = sys>a  , 

/ / S0AC  c = l T P Y , ( 2,  l ) ) , or.  0 = ( c,cCr  ■*-  F ,1  ■>cCl  _ = 7 ins  ,BLKS1  ZF=710G  ) 

• t 'M  so  Tc:  =«  A. nr  . HA1  A.  0 I SP  = ( JL  n , n ASS  ) , i|MI  T=SYSOA, 

//  S,,A'-crjrt>K,(l  7 T» , 1 »)t'V'nl(prr'-..^cfLpcrL  - ''>5Z,ALKSi:,l:=7252> 

//MFt)  00  CS'  =”A.NF.O  AT  A , 0 IS p= (v^W , R ASS  I , UN  I T = SYS OA, 

//  S«*ACr*HKK,{^->-*,ni,')Cn*(*»crF«  = ffLi<FrL  = 3‘>lR1HLKSI2F-35'»‘n 

///'in  no  nsm°  A./  . PA!  A,n!  s»=  (-JEW  ,(»ASS  ) , UN!  T=SYSHA, 

/ / SJ  AG  r -■  ( T p K * ( V,  , 1)1  , OCB  = ( ’^C?  / c , t.  ?fcf.L  =662'.  .BLKS  1/  r = 6 62A  ) 

/ / J X D nn  ”S')--'!A.  1X.OAI  A,OIS°=(UrW  .PASS!  , UN  ! T=SYSOA, 

//  SPACF=<  TRK,  I LOOO.i  ) > ,JCP=  ( R G rc-^f,  LRrC  L=?  ? BO.BLK.S  I ZP=2?^U 

//X!n  m DSN=° A.X  f .PAT  A, 0 I S P = ( NF  W • PASS) t UNI T = 5Y  SOA , 

//  SPACF=  ITRK,  1 IB'. , 1 ))  ,OC3=  (RECF  * = r,  t.RFCL=2Z80,  3LKSIZF=??SO) 

//XYL)  DO  nSU=°  A.XY.OATA,  :)1  SP=  ( JEW,  PASS)  , UNI  T = SYSOA, 

//  SPACF=  1 TP  K,  n,  1 J I ,OCi}=  (»EC=  = LPPCL  = ’A0'+,DLKSI7F  = ?^BN) 

//YXO  00  CSU=»A.YX.nATA ,)T RP= CNFW .PASS) , UNI T=SYSOA, 

//  S ’ AC  F = ( t«  k , ( I 20 , 1 ) ).OCiJ=  (Ptcr  A=F,LRFCL  = 3'.B'.,RLKSIZE=?L.RA) 

//'•'ID  00  0 S M = P A . 1 1,  D A r A , 0 I S°=  (NEW, PASS  ) , UN  JT  = SYSOA, 

//  SoACc=(TRK,I'»,l)),~'CB=('7r:r.F'-I=,:,LPpCL=72A0»BLKSIZc  = ??A0) 

//HKO  00  i!Sf  ’ =»’  A . HG  .DATA,  ) I S P = ( NFW  , P A S S ) , UN  I T=  S Y SO  A , 

//  SP  ACG  = ( t IK  , t 1 , 1 ) ) , ()CB  = ( PECT'^f  , L‘?rCL=  32 A ,dLKS  I ZF=324  ) 

//"NO  00  OSW  = ° A.  P.:.  OAT  A,  0!SP=  (NEW  , P AS S F , UN  1 T = SY SO A , 

//  SP  Ar  F = ( TRK  , ( I ,1  )) , OPrt= ( REGf  'T=FfLPFCL=72n8,BLKSlZF=72  38> 

/ / V W 0 on  PSN-F  A.  V-,  . OA  r A ,0  I s°  = ( JPW  , PASS  ) , UN!  T = SYSnA, 

//  SPAT  c = ( TPK,  ! I , 1 ) ) , OCB  = ( nr-CT  ■l=c  , I ' r CL=  7?  BN  , BIKSIZF  = 7?  ) 


//it/:*  •»** 

//***THf  FOLLOWING  DATA  SOTS  APE  ^nup-n  IF  RFi>ORT  = n-- 

//*e*P?r,  I AT  , CP. C'JNP  , OiiSJ^  0»  03l'»CK  *"*•" 

//*>**  ^ ft- 

//SURTLIB  OP  0SN=SYS1 .SOKTL 1 B ,OI SP=SHR 
//sysoct  r r svsmjT=A 

//>.**  f ft 

//»**  T Mt  FOIL  O'.,'  I MO,  SORT  OATA  SO(S  ALE  °FQUIRFO  *** 

//*■**  [f  0 E Ff.’1’  T=  F rSTAT  *** 

j / 1 i *.  *■** 

//.SORT".'  no  ss\  =TOTALS. DATA ,DISP=(NEW .PASS ) , 

//  ON  I T=  SYSnA.SP ACE= ( T°Y , ( 1 0, 6 ) ) , 

//  UCE=  ( p FCF  *-\  J ,LRFO|  = 20,  'L  KS  I ZC=°m  ) 


//sf'O  TOUT  nz  )SW=(,Sf)D  i pul  ,01  S » = ( Nf  •. , n ASS  1 .UNIT  =SYSnA, 

//  S°AOc=f  T R K , ( 10,5)  ) . OC  n = I R F C c N = c H , L R F f.  L = 7 0 , B L K S I 7 p = **  D 0 1 

/ / SP  ° TV.’K  0 1 no  IJN  1 T--SYSDA  . SP  \ CF  = ( TP  K,  ( l G,  1 ) , , CUNT  FT,) 

//SORT  WK  1?  O1'  UN  I T = S Y S'1  A , S p AC  r = ( n>K,(  IS,)),  ,C(.NFfGI 
//SUP  Tv.ro  3 UIJ  M'<  r T=  SYSOA,  '.PAG  1=  ( T''K, ! 1 r> , \ ) , ,C<"'.Y  I G ) 


//nf*  -r.*f 

/ / * b * T H£  FCILJWING  SQPT  DATA  SITS  A- !;  RFOUTRFO 
//tttlf  pgOQO  IS-  FPOOMP 

/ / **  » *** 


//OAGPFN  oc  osf.  = tn  AG1  » 0 1 SP=  I NE  i , 0 ASS  ) , Uv  1 t = sy  SOA » 

//  <’#rf  = (PYL»(  ! I • 1 ) ) ,DCB=(Prrcv=Fr><LPEF.  l=G?  .BLKSI  Zr=  72BT) 


Figure  2-15.  JCL  for  Executing  DBANAL 
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//i  4G POUT  rc  PSN  = F.'UAG1  PUT  ,!)  I SP  = (Nr.i,P  ASS  ) , UN  1 T=S  YSOA, 

//  SPAC  E=(CYL  . <11  , 1 ) ) t DCB  = ( PFf.F  «’  = F F ,L»  ECl  =4  5,  TLKS  I / r=  T?BO) 

//uagpwk  n rn  unit  - svspa  , spao  = ( cyi  , t f~,  u , .font  \ g ) 

/ / nA C- pi. k p ? nr  i «i  i T - s y spa , s ? \c  1 ( r yi  , ( <■ , n , .cr1MT  i c, ) 

//"A.'.p  ^oi  n.i  'in  i • sys,,a  , s'Mt  t - ( »;v  i , i f . i ) , , r in  t i r, ) 

//r*r.  SIN  n:  '1*1'. -F.U  AG?  , u t SP  ( Nr , PASS)  . t r:  I I = S Y S P A , 

//  r.r>/.r,f  - ( f Yl  , ( ] 1 , 1 ) ) , :0  f "I  r.f  I ’ , I PCI  -5?,;lLKSI7r=72?n) 

//  h;s(.'Jt  r:r;  dsn • »;■  iam  u r . > i s p r"  , .rass  i , u n t-sysd.i, 

//  G » A'  f Z ( r Y(  , * I 1 ,1  ) ) , K.|>-  li'ir.i  -.1-  f 1,1  R^Cl  =S?*r'l.  KS1ZF  - / 2 3 1) 

/ /('  AGSVF  p I I f - v S’i  A , '.''AC  1 ( -.Yt  , ( / , ))  , ,C'J  IT  TG ) 

/ /r  Af.S  > > I''  •'-)]  r , Y SO  A « S i'  A(  T ; ( f Y I , ( i,l  } , , C UNT  I G ) 

k ‘ T)  1 J“ ! I T S Y ’■ 1 1 A , ' ’ ’ r ' * ( C Y L » ( C « 1 ) » » C U N T I G ) 

/ / iAC.P  JN  • s ’ = f.NA  -,)  , ) Ir.  !>  < , 11 A S S ) i!)"l  T = S Y S 0 A » 

/ / S' ’AC)  --  1‘YLi  I 1 1*1  ) ) , ">C  H~  I P F C r A = FntL-iFCL=5?*')LKSIZp=7?nT) 

//‘.jAfPPtJi  rr  fTSN=f..jAr,i'iui  ,)ISp=inf  j.passi  , unt  y=sysda, 

1 / SP  AT.  = r (r  Yl  , Cl  \ , 1 ) ) .or  p = ( * = CF,,=  CI>  , l 3 EC  l = 5?  , GLKSI  7F  = 7?SO  ) 

//►'iGPH'11  ur.  ; T - SvSOA , SPAC'  = ( PY  1 , ( 1)  , , TCMTI  G 1 

✓ /NAGPwKV  Uf  1 T -- SYSDA,  SPACr  =(  CYl , < A,  1 J , INT  1 G ) 

//NAGPW*m  PI'  UNIT  Ysr  A , SPACF=  ( CYL  , ( (, , 11  , ,CONT  I G) 

//NAGSIN  IVJ  US N=  tN  AG?  , 0 I S P-  ( N T <i  » PASS)  »UNIT=SYSDA, 

II  SPArF  = (CYL  •(  1 1 » l ) ) tOCR-(°FCc  •T  = rB,lerCL,=  5?  ,fTLK.SIZc=7?30) 

//NAG  SPLIT  GO  Dc  N-£NAC.?i;UT  , 0 I S p - (N  PA, PASS)  , UNI T=SYSDA, 

//  SPArC=irYL»f  1 1,1  ))  *()PP=('*FCFM=fD»LPFCL-52»,ALKSTZr  = 72RO) 

//*.'  AGSKKOl  HO  UM T 1 = S Y S ")  A , S P AC  F = ( C Y L , ( C» . 1 ) ) , » CONT I G ) 

//NAGSV.K1?  HP  UN  I T=  SYSOA,  SPACF=  I CYL  , ( 6, 1 ) ) , .CONTI  G) 

//NAGS*kKi'»3  no  UN  I I = SY  S1A  , SP.ACr  = (CYL  , ( m,  n ) , .CUNT  IG) 

//rKiASF?  i;o  DSN  - F.  DAT  Cl  A S C?  , UN  IT  = ( T AP  F , 01  T E P ) , DISP=OLD, 


II  l ARFL-C  ,NL)  ,VCL=SFT\=|T  APE1,...  , T A P EN ) , 

II  PCI- (pfcFm  = D,p.LKSI7f  = 7?om 

//*'■* 

//=><*  TIIF  ft, i I Ti’j  I NG  MO  C.ATA  SF  T IS  PFQUIPEO  TF 
//**  *prp(|nT  = rHLnG,  DMSU'T.t  ^ DBI'Y.K.  THF  OPNA’TE 

//=.^*1UST  VA1CM  T t:f  UNF  SOCCIFIEO  (>Y  THE  CUNTPCL  *** 

//^«*CAFG  AlO  I l=PI)NA  ^E  •*** 

//<=<=*  % + n 

//ALOiNP  no  DSN  = CAI  OTN.ni  SP  = OLD,iJNI  T = ( TAPF,  .ocppp  ) , 

//  LABEL =( .Nt  ) ,VCT = SET= AL OND” 

//<*♦  *** 

//''”*  Al  l PFPUKTS  P F ’ HJ  T p F C'liTKlL  CAPOS  UN  THE  *** 

//***SYS  I N FIT''  *** 

II***  4** 

//sysin  on  * 

CONTROL  CARP  !N°UT 

/ » 

// 


Figure  2-15.  JCL  for  Executing  DBANAL 
(3  of  3) 


2-74 


Request  Data  Base  Statistics  Log  Report 


aA 


I 


//SYSIN  DD  * 

START  $ 

REPORT  = DBLOG  $ 

ERRIN  = RAERROR  $ 

CNTLST  = ERRPRINT  $ 

RPTLST  = REPRINT  $ 

ALQIN  = ALQINP  $ 

TERM  $ 

• Request  Data  Base  Startup  Function 

//SYSIN  DD  * 

START  $ 

REPORT  = DBSTUP  $ 

ERRIN  = RAERROR  $ 

CNTLST  = ERRPRINT  $ 

RPTLST  = REPRINT  $ 

DBIN1  = DBASE1  $ 

TERM  $ 

• Request  Data  Base  Statistics  Summary  Report 

//SYSIN  DD  * 

START  $ 

REPORT  = DBSUM  $ 

ERRIN  = RARERROR  $ 

CNTLST  = ERRPRINT  $ 

RPTLST  = REPRINT  $ 

ALQIN  = ALQINP  $ 

TIMINT  = 001000  $ 

TERM  $ 

• Request  Data  Base  Lock  Queue  Statistics  Report 

//SYSIN  DD  * 

START  $ 

REPORT  = DBLOCK  $ 

ERRIN  = RAERROR  $ 

CNTLST  = ERRPRINT  $ 

RPTLST  = REPRINT  $ 

ALQIN  = ALQINP  $ 

TIMINT  = 001000  $ 

TERM  $ 
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2.4.4  Program  Outputs 


2. 4. 4.1  Data  Sets 

There  are  two  data  sets  always  output  by  DBANAL: 

• A sequential  data  set  containing  control  card  images  and 
appropriate  error  diagnostics. 

• A sequential  data  set  containing  the  requested  report. 

The  DDNAMEs  for  these  output  data  sets  are  specified  as  control  card 
parameters  and  are  required  for  successful  program  operation: 

• CNTLST=  DDNAME  of  print  file  for  control  card  images  and  error 

diagnostics . 

• RPTLST=DDNAME  of  data  set  to  which  the  report  is  written 
The  formats  of  the  data  sets  are  described  below : 


DATA  SET 

LRECL 

BLKSIZE 

RECFM 

DSORG 

PRINT  FILE 

133 

1330 

FBA 

PS 

REPORT  FILE 

133 

1330 

FBA 

PS 

For  reports  FRSTAT,  FRCOMP,  DBSUM , and  DBLOCK,  a sort  is  always  performed 
which  requires  an  additional  output  data  set  with  the  DDNAME  of  SYSOUT. 

For  REPORT=DBSTUP,  FRSTAT  or  FRCOMP,  the  data  base  startup  function  is 
invoked.  For  this  function,  all  data  base  sets  are  loaded  to  disk  from 
the  backup  tape. 

2.4.4. 2 Diagnostics 

Diagnostics  generated  by  DBANAL  fall  into  three  categories: 

• User  abend  codes 

• Error  messages 

• I/O  module  messages 
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The  following  user  abends  may  occur: 


USEP  0001 

Meaning:  The  attempt  to  open  the  SYSIN  file  containing  the  control 

cards  was  unsuccessful.  The  probable  cause  is  that  the  DDNAME 
SYSIN  was  not  provided  in  the  JCL. 

USER  0002 

Meaning:  A serious  error  occurred  during  processing.  The  probable 
cause  is  an  I/O  error  on  an  input  or  output  file.  Refer  to  the 
associated  message  on  the  HASP  output  log. 

USER  0003 

Meaning:  No  valid  control  card  set  was  found  on  the  SYSIN  file. 
Verify  the  control  card  input  for  accuracy. 

USER  0004 

Meaning:  The  error  message  data  set  could  not  be  opened  or  its 
DDNAME  was  not  supplied  as  a control  card  parameter.  Verify  that 
the  control  card  ERRIN=DDNAME  of  error  message  set  is  present  in 
the  control  card  set. 

USER  0005 

Meaning:  A serious  error  occurred  while  parsing  the  control  cards. 
Either  an  end-of-file  was  encountered  on  the  SYSIN  file  prior  to 
encountering  a TERM  $ control  card  or  an  I/O  error  occurred  while 
scanning  SYSIN. 


The  following  are  error  messages  which  may  be  printed  and  the  condition 
indicated  caused  program  termination. 

MESSAGE:  RA0001  INVALID  CHARACTER  IN  CONTROL  CARD  FIELD 
Meaning : An  unacceptable  non-alphanumeric  character  was  encountered 
on  a control  card.  Compool  table  BH  contains  the  valid  special 
characters . 


MESSAGE:  RA0002  FIELD  LENGTH  EXCEEDS  EIGHT  CHARACTERS 

Meaning:  A control  card  keyword  or  keyword  parameter  was  found  to 

be  greater  than  8 characters  in  length. 


MESSAGE:  RA0003  MISSING  OR  INVALID  CONTROL  CARD  KEYWORD 

Meaning:  An  acceptable  control  card  keyword  was  not  encountered 

at  the  onset  of  a keyword  expression.  The  intended  keyword  is 

either  misspelled  or  has  been  omitted.  The  following  keywords 

are  acceptable: 

ALQIN  ERRIN 

CNTLST  REPORT 

DBIN1  RPTLST 

DBIN2  START 

ENDTIM  TERM 

ENDDAT  TIMINT 

TIMSPAN 

MESSAGE:  RA0004  MISSING  OR  INVALID  VALUE  - XXXX  EXPECTED 
Meaning:  An  equal  sign  or  other  delimiter  was  not  encountered  at 
the  appropriate  point  in  the  keyword  expression.  XXXX  equals  the 
expected  value. 


MESSAGE:  RA0005  INVALID  TIME/DATE  ENTRY 

Meaning : A portion  of  the  time/date  field  includes  an  out  of  range 

value,  a field  is  not  six  digits,  or  the  time/date  entries  do  not 
represent  a time  range. 


[1 
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MESSAGE:  RA0007  TOO  MANY  IDENTIFIERS  FOR  KEYWORD 


Meaning:  The  maximum  allowable  number  of  parameters  for  a particular 
keyword  has  been  exceeded.  Compool  table  IS  contains  the  maximum 
values  for  associated  keywords. 

MESSAGE:  RA0008  INVALID  IDENTIFIER  IN  DESTINATION  FIELD 

Meaning:  Appropriate  keyword  parameters  were  not  found  following  a 

valid  keyword  in  the  control  card  set. 

MESSAGE:  RA0009  INVALID  PARAMETER  FOR  THIS  REPORT  - XXXXXXXX 
Meaning:  The  parameter  indicated  is  an  invalid  keyword  for  the 
report  generated. 

MESSAGE:  RA010  CNTLST  AND/OR  ERRIN  FILE(S)  NOT  OPENED  FOR  PRIOR 
REPORT(S) 

Meaning:  For  multiple  report  requests  in  one  control  card  set , the 
indicated  keywords  designating  the  print  file  and  error  message  file 
were  not  found  with  the  prior  report  requests.  The  current  report 
will  be  generated;  the  prior  reports  requested  will  not  be  generated. 

MESSAGE:  RA033  OPEN  ERROR  FOR  FLIGHT  RECORD  SET  #1  IN  RACNNR  MODULE 
Meaning : An  open  error  occurred  on  the  work  data  set  specified  by 
the  DDNAME  OAGPIN  or  NAGPIN.  Refer  to  the  associated  I/O  message 
in  the  HASP  output  log. 

MESSAGE:  RA035  READ  ERROR  ON  1ST  READ  FOR  FLIGHT  RECORD  SET  #1 
IN  RACNNR 

Meaning:  An  error  occurred  on  the  first  read  of  the  work  data  set 
specified  by  the  DDNAME  OAGPIN  or  NAGPIN.  Refer  to  the  associated 
I/O  message  in  the  HASP  output  log. 


r 


MESSAGE:  RA036  READ  ERROR  ON  FIRST  READ  FOR  FLIGHT  RECORD 
SET  #2  IN  RACNNR 

Meaning:  An  error  occurred  on  the  first  read  of  the  work  data  set 
specified  by  the  DDNAME  OAGSIN  or  NAGSIN.  Refer  to  the  associated 
I/O  message  in  the  HASP  output  log. 

MESSAGE:  RA037  WRITE  ERROR  IN  RADBSR  MODULE 

Meaning:  An  error  occurred  while  attempting  to  write  the  flight 

record  compare  (FRCOMP)  report  summary  lines.  Refer  to  the  associated 
I/O  message  in  the  HASP  output  log. 

MESSAGE:  RA038  READ  ERROR  ON  2ND  OR  SUBSEQUENT  READ  FOR  SET  #1 
IN  RACNNR 

Meaning:  An  error  occurred  while  attempting  to  read  from  the  work 

data  set  specified  by  the  DDNAME  OAGPIN  or  NAGPIN.  Refer  to  the 
associated  I/O  messages  in  the  HASP  output  log. 

MESSAGE:  RA039  READ  ERROR  ON  2ND  OR  SUBSEQUENT  READ  FOR  FLIGHT 
RECORD  SET  #2 

Meaning:  An  error  occurred  while  attempting  to  read  from  the  work 

data  set  specified  by  the  DDNAME  OAGSIN  or  NAGSIN.  Refer  to  the 
associated  I/O  message  in  the  HASP  output  log. 

MESSAGE : RA040  WRITE  ERROR  IN  RAFDBR  MODULE 

Meaning:  An  error  occurred  while  attempting  to  write  the  flight 

record  compare  (FRCOMP)  report.  Refer  to  the  associated  I/O  message 
in  the  HASP  output  log. 

MESSAGE:  RA041  DATA  BASE  ERROR  IN  RACCDB  MODULE 
Meaning:  The  Compool  table  A2  was  being  searched  for  a specific 
keyword  that  was  not  found.  The  module  RACCDB  contains  a list  of 
keywords  that  are  expected  to  be  defined  in  A2.  This  is  a serious 
error  that  will  require  program  DR  Compool  modifications. 


1 


1 


r 

I 

I 

: 

IE 


2-80 


MESSAGE:  RA042  OPEN  ERROR  FOR  FLIGHT  RECORD  SET  #2  IN  RACNNR 


Meaning : An  open  error  occurred  on  the  work  data  set  specified  by 

the  DDNAME  OAGSIN  or  NAGSTN.  Holer  to  the  associated  I/O  message 
in  t he  HASP  Output  Log. 

MESSAGE : RA043  SORT  ERROR  IN  RACCMP  MODULE 

Meaning:  An  error  occurred  during  the  sort  processing.  Refer  to 

the  sort  messages  on  the  SYSOUT  data  set. 

MESSAGE:  RA045  ERROR  STATUS  RETURNED  FROM  XXXXX 

Meaning:  The  I/O  module  indicated  returned  an  error  status.  The 

I/O  module  was  unable  to  process  the  data  set.  Either  the  data  set 
could  not  be  opened  (XXXXX=DAOPN ) or  an  I/O  error  occurred  while 
attempting  to  read  (if  XXXXX=DARED)  or  while  attempting  to  write 
(if  XXXXX=DAWRIT) . If  the  data  set  could  not  be  opened,  the  most 
probable  cause  is  that  the  DDNAME  was  not  specified  in  the  JCL. 
Refer  to  the  associated  I/O  message  in  the  HASP  output  log. 

MESSAGE:  RA047  NO  DATA  BASE  STATISTICS  RECORDS  FOUND  ON  INPUT 
DATA  SET 

Meaning:  The  report  requested  was  DBSUM,  DBLOCK,  or  DBLOG  which 
process  data  base  statistics  records  from  an  input  ALQ  set.  The 
DDNAME  of  the  ALQ  Input  Set  is  specified  by  the  control  card 
ALQIN=DDNAME.  No  data  base  statistics  records  were  found  on  this 
input  set. 
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The  following  are  I/O  module  messages  that  may  appear  on  the  HAF-F  output 
log.  In  all  cases,  an  I/O  error  will  cause  program  termination. 


MESSAGE:  AAAAAAAA  ERROR  ON  01*1  N 

Meaning : The  data  set  assoc i, it ed  with  the  DDNAME  (AAAAAAAA)  could 

not  be  opened.  The  probable  cause  is  that  the  DDNAME  indicated 
was  not  provided  in  the  JCL. 

MESSAGE:  AAAAAAAA  GIVES  TOO  MANY  PDS  FILES 

Meaning:  The  maximum  number  of  partitioned  data  sets  that  may  be 
open  at  any  one  time  is  5.  AAAAAAAA  is  the  PDNAME  of  the  file 
to  be  opened  when  the  limit  was  exceeded. 

MESSAGE:  AAAAAAAA  GIVES  TOO  MANY  I/O  FILES 

Meaning : The  maximum  number  of  input/output  data  sets  that  may  be 

open  at  any  one  time  is  20.  AAAAAAAA  is  the  DDNAME  of  the  data  set 
to  be  opened  when  the  limit  was  exceeded. 

MESSAGE : AAAAAAAA  IS  UNABLE  TO  GET  SUFFICIENT  CORE  FOR  DCB 
Meaning:  There  was  insufficient  core  available  when  the  data  set 

specified  by  the  DDNAME  (AAAAAAAA)  indicated  was  to  be  opened. 


